MCP سرورز، سیٹنگز اور ہسٹری شیئر کریں

ہر اکاؤنٹ اپنا لاگ اِن الگ رکھتا ہے۔ باقی سب کچھ آئٹم بہ آئٹم شیئر کیا جا سکتا ہے: ccam اکاؤنٹ کی فائل یا فولڈر کو ایک شیئر شدہ گروپ فولڈر سے لنک کرتا ہے، اس لیے ایک اکاؤنٹ میں کی گئی تبدیلی اس گروپ کے تمام اکاؤنٹس میں نظر آتی ہے۔

کیا کچھ شیئر کیا جا سکتا ہے

نئے اکاؤنٹس گفتگو کی ہسٹری کے سوا سب کچھ شیئر کرتے ہیں۔

لاگ اِن کی فائلیں .credentials.json اور .claude.json کبھی شیئر نہیں ہوتیں۔ ccam صرف ایک طے شدہ فہرست میں موجود راستوں کو لنک کرتا ہے، اور یہ دونوں فائلیں اس فہرست میں نہیں ہیں۔

گروپس

on کا مطلب default گروپ ہے۔ آپ کوئی نام بھی دے سکتے ہیں، تاکہ کوئی آئٹم صرف کچھ اکاؤنٹس کے درمیان شیئر ہو:

ccam share work --history team
ccam share side --history team

اب work اور side آپس میں گفتگو شیئر کرتے ہیں، لیکن آپ کے دوسرے اکاؤنٹس کے ساتھ نہیں۔

شیئرنگ آن کرنا

جب کوئی اکاؤنٹ کسی آئٹم کو شیئر کرنا شروع کرتا ہے تو ccam:

1. ہر اس فائل کا منصوبہ پرنٹ کرتا ہے جسے وہ منتقل، کاپی یا لنک کرے گا، اور شروع کرنے سے پہلے آپ سے پوچھتا ہے؛
2. اگر گروپ ابھی خالی ہے تو اکاؤنٹ کی فائلیں گروپ فولڈر میں منتقل کرتا ہے، ورنہ وہ فائلیں شامل کرتا ہے جو گروپ میں ابھی موجود نہیں؛
3. جب ایک ہی فائل دونوں جگہ مختلف ہو تو پوچھتا ہے کہ گروپ کا ورژن رکھا جائے، آپ کا ورژن استعمال کیا جائے، یا JSON کو ملا دیا جائے؛
4. آپ کی اصل فائل اکاؤنٹ فولڈر کے اندر .ccam-backup/<time>/ میں محفوظ رکھتا ہے؛
5. اصل فائل کی جگہ گروپ کا لنک لگا دیتا ہے۔

گفتگو کی فائلوں کے نام ان کے سیشن ID پر رکھے جاتے ہیں، اس لیے کئی اکاؤنٹس کی ہسٹریاں بغیر کسی ٹکراؤ کے یکجا ہو جاتی ہیں۔

جب Claude Code اس اکاؤنٹ کے طور پر چل رہا ہو تو ccam شیئرنگ تبدیل نہیں کرتا، کیونکہ سیشن ان فائلوں میں لکھتا رہتا ہے جو منتقل کی جا رہی ہوتی ہیں۔ پہلے اسے بند کریں۔

شیئرنگ بند کرنا

ccam share work --history off

لنک ہٹا دیا جاتا ہے اور اکاؤنٹ کو گروپ کے موجودہ مواد کی اپنی کاپی مل جاتی ہے۔ اس کے بجائے خالی حالت سے شروع کرنے کے لیے --fresh شامل کریں۔ گروپ اپنا مواد دوسرے اکاؤنٹس کے لیے برقرار رکھتا ہے۔

موجودہ سیٹ اپ کاپی کریں

اگر آپ ccam سے پہلے Claude Code استعمال کرتے تھے تو آپ کی سیٹنگز ~/.claude میں ہیں۔ ccam migrate انہیں ایک گروپ میں کاپی کرتا ہے، تاکہ وہ آئٹمز شیئر کرنے والے ہر اکاؤنٹ کو یہ مل جائیں:

ccam migrate

ٹرمینل پر ccam پہلے آئٹمز کی ایک چیک لسٹ دکھاتا ہے۔ گفتگو کی ہسٹری کے سوا سب کچھ چیک ہوتا ہے؛ کسی آئٹم کو بدلنے کے لیے Space اور پلان دیکھنے کے لیے Enter دبائیں۔ جن آئٹمز کے لیے فولڈر میں کچھ نہیں ہوتا ان پر not found لکھا ہوتا ہے۔

یہ کیا کاپی کرتا ہے:

• settings.json اور گلوبل CLAUDE.md؛
• ایکسٹینشنز agents/، commands/، skills/، plugins/، output-styles/ اور rules/؛
• آپ کے یوزر MCP سرورز، یعنی ~/.claude.json کی mcpServers اینٹری، گروپ کی mcp.json میں؛
• جن MCP سرورز کو یہ کاپی کرتا ہے ان کے محفوظ کیے گئے سائن اِن (OAuth)، ہر اکاؤنٹ کی اپنی لاگ اِن فائل میں؛
• گفتگو کی ہسٹری (projects/ اور history.jsonl)، لیکن صرف تب جب آپ --history لگائیں۔

سورس فولڈر کو صرف پڑھا جاتا ہے: اس میں کچھ بھی منتقل، لنک یا تبدیل نہیں ہوتا، اور سادہ claude پہلے کی طرح کام کرتا رہتا ہے۔ لاگ اِن فائلیں .credentials.json اور .claude.json کبھی گروپ میں کاپی نہیں ہوتیں۔

جو MCP سرورز OAuth سے سائن اِن کرتے ہیں وہ اپنے ٹوکنز سرورز کی فہرست میں نہیں بلکہ لاگ اِن میں رکھتے ہیں۔ تاکہ آپ کو ان میں دوبارہ سائن اِن نہ کرنا پڑے، ccam یہ سائن اِن ہر اس اکاؤنٹ کی لاگ اِن فائل میں کاپی کرتا ہے جسے گروپ کے ذریعے سرورز ملتے ہیں، سوائے اس کے کہ اکاؤنٹ کے پاس پہلے سے اپنے سائن اِن ہوں۔ یہ ان اکاؤنٹس کو چھوڑ دیتا ہے جو چل رہے ہوں، ابھی لاگ اِن نہ ہوئے ہوں، ccam import سے اپنی جگہ پر رجسٹر کیے گئے ہوں، یا اپنا لاگ اِن macOS Keychain میں رکھتے ہوں، اور ان کے نام بتا دیتا ہے؛ وہاں /mcp سے سرورز میں سائن اِن کریں۔ جو اکاؤنٹ بعد میں MCP سرورز شیئر کرنا شروع کرے، اسے سائن اِن تب ملتے ہیں جب آپ ccam migrate دوبارہ چلاتے ہیں۔

کچھ بھی کاپی کرنے سے پہلے ccam منصوبہ دکھاتا ہے اور پوچھتا ہے:

$ ccam migrate
Copy from /home/me/.claude into group default (/home/me/.local/share/ccam/groups/default):
  mcp         ~/.claude.json  new: context7, fs
  settings    settings.json   new: 80 B
  memory      CLAUDE.md       new: 31 B
  extensions  agents/         add 1 file the group lacks (17 B)
              commands/       add 1 file the group lacks (15 B)
              skills/         add 1 file the group lacks (32 B)
              not found, skipped: plugins/, output-styles/, rules/
  Conversation history (projects/, history.jsonl) is not included; add --history to copy it.
Copy these into group default? [y/N] y
✓ Copied into group default: 2 MCP servers, settings.json, CLAUDE.md, agents/, commands/, skills/
Accounts that share these through group default:
  mcp         personal
  settings    personal
  memory      personal
  extensions  personal

آخر میں ccam ان اکاؤنٹس کی فہرست دکھاتا ہے جو ہر آئٹم کو گروپ کے ذریعے شیئر کرتے ہیں۔ اگر کچھ اکاؤنٹس ایسا نہیں کرتے تو یہ وہ ccam share کمانڈز دکھاتا ہے جو ان کے لیے شیئرنگ آن کرتی ہیں۔

جب گروپ کے پاس کسی فائل کی پہلے سے مختلف کاپی ہو تو ccam، شیئرنگ آن کرتے وقت کی طرح، پوچھتا ہے: گروپ کی کاپی رکھیں یا اپنی استعمال کریں۔ settings.json اور دوسری JSON فائلیں ضم بھی کی جا سکتی ہیں، اور history.jsonl لائن بہ لائن۔ گروپ کی پچھلی کاپیاں گروپ فولڈر کے اندر .ccam-backup/<time>/ میں محفوظ ہوتی ہیں۔

کچھ کاپی کیے بغیر منصوبہ دیکھنے کے لیے کمانڈ سے پہلے --dry-run لگائیں، جیسے ccam --dry-run migrate۔ کسی دوسرے فولڈر سے کاپی کرنے کے لیے اس کا نام دیں: ccam migrate ~/.claude-work --group work۔

MCP سرورز

Claude Code، MCP سرورز کو لاگ اِن کے ساتھ .claude.json میں رکھتا ہے، اس لیے یہ فائل شیئر نہیں کی جا سکتی۔ ccam شیئر کیے گئے سرورز کو گروپ کی mcp.json میں رکھتا ہے اور Claude Code کو --mcp-config=<group>/mcp.json کے ساتھ شروع کرتا ہے۔ آپ کے اپنے --mcp-config آپشنز بھی اس کے اوپر لاگو رہتے ہیں۔

ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code
ccam mcp list

جو سرور آپ کسی سیشن کے اندر claude mcp add سے شامل کرتے ہیں وہ صرف اسی اکاؤنٹ کے لیے محفوظ ہوتا ہے۔ اگلی بار جب آپ وہ اکاؤنٹ شروع کریں گے تو ccam اس سرور کا نام اور وہ کمانڈ بتائے گا جو اسے گروپ میں منتقل کرتی ہے:

ccam mcp import work gh

اگر گروپ میں اسی نام کا کوئی مختلف سرور پہلے سے موجود ہو تو ccam اسے چھوڑ دیتا ہے اور یہ بتا دیتا ہے۔ --force گروپ کا سرور بدل دیتا ہے اور پرانی mcp.json گروپ کے .ccam-backup/ فولڈر میں رکھ لیتا ہے۔

جو MCP سرورز OAuth سے سائن اِن کرتے ہیں وہ اپنے ٹوکنز اکاؤنٹ کے لاگ اِن کے ساتھ محفوظ کرتے ہیں، اس لیے ہر اکاؤنٹ میں انہیں ایک بار اجازت دیں، یا ccam migrate سے ~/.claude کے سائن اِن کاپی کریں۔

اگر آپ چاہتے ہیں کہ سرورز claude mcp list اور /mcp میں عام یوزر سرورز کے طور پر نظر آئیں تو ~/.config/ccam/config.toml میں mcp_strategy = "sync" سیٹ کریں۔ اس صورت میں ccam شروع کرنے سے پہلے انہیں ہر اکاؤنٹ کی .claude.json میں لکھ دیتا ہے، Claude Code کے اپنے فائل لاک کے تحت اور بیک اپ کے ساتھ۔

ایک ہی فولڈر میں دو اکاؤنٹس

جو اکاؤنٹس گفتگو کی ہسٹری شیئر کرتے ہیں وہ ایک ہی فائلوں میں لکھتے ہیں۔ اگر آپ کسی ایسے فولڈر میں دوسرا Claude Code شروع کریں جہاں اسی گروپ کا کوئی اور اکاؤنٹ پہلے سے چل رہا ہو تو ccam آپ کو خبردار کرتا ہے اور پوچھتا ہے کہ جاری رکھنا ہے یا نہیں۔

جب کچھ خراب ہو جائے

ccam doctor
ccam doctor --fix

اگر کوئی شیئر شدہ راستہ عام فائل بن گیا ہو، مثلاً جب آپ نے ہاتھ سے کوئی بیک اپ بحال کیا ہو، تو ccam، Claude Code شروع کرنے سے پہلے رک جاتا ہے اور ccam doctor --fix کی طرف اشارہ کرتا ہے، جو اس فائل کو گروپ میں ضم کر دیتا ہے اور بیک اپ رکھتا ہے۔