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

اگر آپ ccam سے پہلے Claude Code استعمال کرتے تھے تو آپ کا سیٹ اپ ~/.claude اور ~/.claude.json میں ہے۔ ccam migrate اسے ایک شیئر گروپ میں کاپی کرتا ہے، تاکہ جو بھی اکاؤنٹ گروپ کے ذریعے وہ آئٹمز شیئر کرے وہ آپ کے موجودہ سیٹ اپ کے ساتھ شروع ہو۔ سورس فولڈر کو صرف پڑھا جاتا ہے، اور سادہ claude پہلے کی طرح کام کرتا رہتا ہے۔ اسے اپنے پہلے ccam add کے بعد ایک بار چلائیں، اور پھر جب بھی کوئی اکاؤنٹ MCP سرورز شیئر کرنا شروع کرے۔

استعمال

ccam migrate                         # ~/.claude into group default, checklist on a terminal
ccam --dry-run migrate               # show the plan, copy nothing
ccam migrate --settings --mcp        # only these items, no checklist
ccam migrate --history --yes         # conversation history only, no questions
ccam migrate ~/.claude-work --group work

ٹرمینل پر، آئٹم فلیگز اور --yes کے بغیر، ccam پہلے ایک چیک لسٹ دکھاتا ہے:

 Copy into group default

 From /home/me/.claude
 ? Choose what to copy (Space to toggle)
 › [x] MCP servers
   [x] settings.json
   [x] global CLAUDE.md
   [x] agents, commands, skills
   [ ] conversation history

 Enter show the plan · Esc cancel

Space (یا x) کرسر کے نیچے والا آئٹم بدلتا ہے، تیر والی کیز یا j/k حرکت دیتی ہیں، Enter منصوبہ دکھاتا ہے، اور Esc، q یا Ctrl+C، Cancelled. پرنٹ کرتے ہیں۔ جن آئٹمز کے لیے سورس میں کچھ نہیں ہوتا ان پر not found لکھا ہوتا ہے۔ اگر آپ سب کچھ ان چیک کر دیں تو ccam، Nothing selected. پرنٹ کر کے رک جاتا ہے۔

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

$ ccam migrate --yes
Copy from /home/me/.claude into group default (/home/me/.local/share/ccam/groups/default):
  mcp         ~/.claude.json  new: fs, linear
              sign-ins        linear → personal; skipped: work (not logged in yet)
  settings    settings.json   new: 61 B
  memory      CLAUDE.md       new: 11 B
  extensions  agents/         add 1 file the group lacks (6 B)
              skills/         add 1 file the group lacks (13 B)
              not found, skipped: commands/, plugins/, output-styles/, rules/
  Conversation history (projects/, history.jsonl) is not included; add --history to copy it.
✓ Copied into group default: 2 MCP servers, settings.json, CLAUDE.md, agents/, skills/, MCP sign-ins for personal
MCP sign-ins were not copied to: work (not logged in yet). Sign in to those servers there with /mcp.
Accounts that share these through group default:
  mcp         personal, work
  settings    personal, work
  memory      personal, work
  extensions  personal, work

گروپ صرف ان اکاؤنٹس تک پہنچتا ہے جو اس کے ذریعے کوئی آئٹم شیئر کرتے ہیں، اس لیے خلاصہ ہر آئٹم کے لیے ان کی فہرست دیتا ہے۔ جو اکاؤنٹس شیئر نہیں کرتے ان کے لیے ccam وہ ccam share <name> --<item> on کمانڈز پرنٹ کرتا ہے جو شیئرنگ آن کرتی ہیں۔

آپشنز

کوئی آئٹم فلیگ نہ ہو تو ٹرمینل پر چیک لسٹ فیصلہ کرتی ہے۔ ٹرمینل کے باہر، یا --yes کے ساتھ، ccam گفتگو کی ہسٹری کے سوا سب کچھ کاپی کرتا ہے۔ ہسٹری ڈیفالٹ طور پر چھوڑ دی جاتی ہے کیونکہ projects/ بڑا ہو سکتا ہے۔

--group on کا مطلب default ہے۔ --group off اور --group local، --group takes a group name, not "off" کے ساتھ مسترد ہوتے ہیں۔ ccam migrate، --dry-run کو لاگو کرتا ہے، اور ڈرائی رن میں بھی چیک لسٹ ظاہر ہوتی ہے تاکہ آپ کسی انتخاب کا پیشگی جائزہ لے سکیں۔

یہ کیسے کام کرتا ہے

internal/cli/migrate.go آئٹمز چنتا ہے، پھر migrate.Build سورس اور گروپ کو پڑھ کر ایک منصوبہ لوٹاتا ہے۔ آپ کی تصدیق کے بعد Plan.Apply تک کچھ نہیں لکھا جاتا۔

1. سورس تلاش کرنا۔ checkSource ایسا راستہ مسترد کرتا ہے جو موجود نہ ہو، فولڈر نہ ہو، یا جس میں Claude Code کی کوئی معلوم اینٹری نہ ہو۔ migrate.ClaudeJSON وہ .claude.json تلاش کرتا ہے جو فولڈر سے تعلق رکھتی ہے: اس کے اندر، یا ~/.claude کے لیے جس کے اندر کوئی نہ ہو، اس کے ساتھ والی ~/.claude.json۔ جب CLAUDE_CONFIG_DIR مقرر نہ ہو تو Claude Code اسے وہیں رکھتا ہے۔
2. آئٹمز کو راستوں سے جوڑنا۔ ہر راستہ share.Layout سے آتا ہے، وہی اجازت شدہ فہرست جو ccam share استعمال کرتا ہے۔ MCP سرورز .claude.json میں سے mcp.LocalServers سے پڑھے جاتے ہیں، جو پوری فائل پارس کرنے کے بجائے profile.TopLevelValue اسکینر استعمال کرتا ہے۔
3. کاپی کرنا، کبھی منتقل نہیں۔ فائلیں fsutil.AtomicWrite یا fsutil.CopyFile سے ~/.local/share/ccam/groups/<group>/ میں جاتی ہیں؛ MCP سرورز گروپ کی mcp.json میں جاتے ہیں۔

ہر آئٹم ایک سورس راستے کو ایک گروپ راستے سے جوڑتا ہے:

ہسٹری کی دو قطاریں ڈیش والی ہیں کیونکہ وہ صرف --history کے ساتھ کاپی ہوتی ہیں۔ .credentials.json اور .claude.json، share.Never میں درج ہیں اور کبھی گروپ تک نہیں پہنچتیں: اگر ان میں سے کوئی کبھی ترتیب میں نظر آئے تو Build اندرونی غلطی لوٹاتا ہے، اور فولڈر کی تلاش انہیں نام سے چھوڑ دیتی ہے۔

buildEntry ہر راستے کو ایک حالت دیتا ہے، اور منصوبے کی ہر لائن یہی بیان کرتی ہے:

• Missing: سورس میں نہیں، یا جہاں فولڈر متوقع ہو وہاں فائل۔ ہر آئٹم کے لیے ایک بار not found, skipped کے طور پر دکھایا جاتا ہے۔
• Linked: سورس راستہ پہلے سے گروپ کی کاپی تک پہنچتا ہے، مثلاً جب سورس ccam کا کوئی پروفائل فولڈر ہو۔
• Same: گروپ میں پہلے سے بالکل وہی مواد ہے۔
• New: گروپ میں یہ نہیں ہے، اس لیے یہ پورا کاپی ہوتا ہے۔
• Merge: دونوں طرف ایک فولڈر۔ copyMissing صرف وہ فائلیں شامل کرتا ہے جو گروپ میں نہیں ہیں؛ مختلف فائلیں ویسی ہی رہتی ہیں جیسی گروپ میں ہیں اور منصوبہ group copies kept کہتا ہے۔ plugins/ کے لیے، رجسٹریز installed_plugins.json اور known_marketplaces.json ملا دی جاتی ہیں، اور پلگ اِنز کے مکمل راستے گروپ کے فولڈر کی طرف دوبارہ لکھے جاتے ہیں۔
• Conflict: دونوں طرف ایک فائل جس کا مواد مختلف ہو۔ آپ ہر فائل کے لیے چنتے ہیں: keep group، use mine، اور .json فائلوں کے لیے merge JSON (گہرا انضمام جس میں ٹکراتی قدروں پر گروپ کو ترجیح ملتی ہے) یا history.jsonl کے لیے merge by line۔ جس MCP سرور کی تعریف مختلف ہو وہ بھی ٹکراؤ ہے، keep group یا use mine کے ساتھ۔ پہلا دکھایا گیا انتخاب Enter دبانے پر ڈیفالٹ ہے؛ --yes ہمیشہ گروپ کی کاپی رکھتا ہے۔

چیک لسٹ خود tui.MigratePicker ہے، جو اسی checklist جزو پر بنی ہے جو ccam add استعمال کرتا ہے؛ migrate.Found غائب آئٹمز کو lstat کالز اور MCP سرورز کی فہرست سے نشان زد کرتا ہے۔

MCP سائن اِن

جو MCP سرورز OAuth سے سائن اِن کرتے ہیں وہ اپنے ٹوکنز سرورز کی فہرست میں نہیں بلکہ لاگ اِن فائل میں رکھتے ہیں، یعنی .credentials.json میں mcpOAuth کے تحت۔ Claude Code ہر اینٹری کی key، <name>| اور سرور کے type، url اور headers کے sha256 hash کے پہلے 16 حروف سے بناتا ہے۔ key فولڈر پر منحصر نہیں، اس لیے کاپی کی گئی اینٹری دوسرے اکاؤنٹ میں تب تک کام کرتی ہے جب تک سرور کی تعریف بالکل وہی ہو۔ اسی لیے internal/migrate/logins.go میں buildLogins صرف ان سرورز کی اینٹریز کاپی کرتا ہے جو آخرکار گروپ میں سورس والی تعریف کے ساتھ ہوں: نئے، پہلے سے یکساں، یا ایسا ٹکراؤ جس میں آپ نے use mine چنا ہو۔ پلگ اِن سرورز کے سائن اِن (جن کی keys plugin: سے شروع ہوتی ہیں) تب ساتھ جاتے ہیں جب آپ ایکسٹینشنز کاپی کریں اور سورس میں plugins/ ہو۔

اینٹریز ہر وصول کرنے والے اکاؤنٹ کی اپنی .credentials.json میں جاتی ہیں، جو fsutil.AtomicWrite سے موڈ 0600 پر لکھی جاتی ہے۔ یہ کبھی گروپ میں نہیں جاتیں۔ کسی اکاؤنٹ کو یہ صرف تب ملتی ہیں جب وہ ہدف گروپ کے ذریعے mcp (یا پلگ اِن سرورز کے لیے extensions) شیئر کرتا ہو، اور صرف وہ keys شامل ہوتی ہیں جو اس کے پاس نہیں: جو اینٹریز اس کے پاس پہلے سے ہیں، شاید زیادہ نئی، وہ برقرار رہتی ہیں۔ منصوبے کی sign-ins لائن سرورز، وصول کرنے والے اکاؤنٹس اور چھوڑے گئے اکاؤنٹس دکھاتی ہے۔ ccam کسی اکاؤنٹ کو چھوڑ دیتا ہے، اور وجہ کے ساتھ اس کا نام بتاتا ہے، جب وہ:

• ccam import سے اپنی جگہ پر رجسٹر کیا گیا ہو، کیونکہ سادہ claude اس کی لاگ اِن فائل استعمال کر رہا ہو سکتا ہے؛
• چل رہا ہو، کیونکہ Claude Code اس کی لاگ اِن فائل دوبارہ لکھتا ہے (لکھنے سے فوراً پہلے دوبارہ جانچا جاتا ہے، اور started meanwhile کے طور پر بتایا جاتا ہے)؛
• ابھی لاگ اِن نہ ہوا ہو؛
• اپنا لاگ اِن macOS Keychain میں رکھتا ہو، جس میں ccam نہیں لکھتا۔

چھوڑے گئے اکاؤنٹ میں سرورز میں /mcp سے سائن اِن کریں۔ جو اکاؤنٹ بعد میں MCP سرورز شیئر کرنا شروع کرے اسے سائن اِن تب ملتے ہیں جب آپ ccam migrate دوبارہ چلائیں؛ خلاصہ یہ Then run `ccam migrate` again to give them the MCP sign-ins too. کے ساتھ بتاتا ہے۔

حفاظت اور خاص صورتیں

• سورس کو صرف پڑھا جاتا ہے۔ اس کی کوئی فائل منتقل، لنک یا تبدیل نہیں ہوتی، اور سورس کا لاگ اِن کبھی نہیں لکھا جاتا، macOS پر بھی جہاں اسے Keychain سے پڑھا جا سکتا ہے۔
• گروپ کی کوئی فائل بدلنے سے پہلے، چاہے use mine سے، انضمام سے، یا موجودہ mcp.json میں نئے MCP سرورز سے، گروپ کی کاپی <group>/.ccam-backup/<time>/ میں محفوظ ہوتی ہے۔ فولڈر کا نام ہر رن کے لیے منفرد ہوتا ہے، اس لیے ایک ہی سیکنڈ میں دو رن ایک دوسرے کے بیک اپ اوور رائٹ نہیں کرتے۔ خلاصہ راستہ پرنٹ کرتا ہے۔
• --yes کے ساتھ ہر ٹکراؤ میں گروپ کی کاپی رکھی جاتی ہے، اور ccam بتاتا ہے کہ اس کے بجائے خود کیسے چنیں: وہی کمانڈ --yes کے بغیر چلائیں۔
• اگر کچھ نہ بدلے تو ccam، Nothing to copy. پرنٹ کرتا ہے؛ اگر ہر ٹکراؤ میں گروپ کی کاپی رکھی جائے تو Nothing to copy: the group keeps its own copies.
• اگر کاپی آدھے راستے میں ناکام ہو تو ccam، The source folder was not changed. Group files replaced so far are saved in اور اس کے بعد بیک اپ فولڈر کے ساتھ رک جاتا ہے۔
• سورس نہ ہو تو عمل no Claude Code folder at <path>. Give the folder to copy from: ccam migrate <folder> پر ختم ہوتا ہے۔

متعلقہ

• MCP سرورز، سیٹنگز اور ہسٹری شیئر کریں
• جانچ اور مرمت
• Claude Code کے ایک سے زیادہ اکاؤنٹس
• CLAUDE_CONFIG_DIR