शॉर्टकट कमांड्स

शॉर्टकट ही तुम्ही स्वतः नाव दिलेली कमांड आहे, जी Claude Code एका खात्याने सुरू करते: ccwork --resume तेच करते जे ccam work --resume करते. ती ~/.local/bin मधील ccam ची लिंक आहे, त्यामुळे ती bash, zsh, scripts आणि PATH वरून प्रोग्राम चालवणाऱ्या इतर सर्व गोष्टींमध्ये चालते. शॉर्टकट ऐच्छिक आहेत; तुम्ही वारंवार सुरू करता त्या खात्यांसाठी एक तयार करा.

वापर

ccam shortcut work ccwork     # create the shortcut ccwork for work
ccam shortcut 2 ccside        # the account with number 2
ccam shortcut work            # show it
ccam shortcut work ccw        # rename it; the old link is removed
ccam shortcut work --remove   # delete it
ccam add side --shortcut ccside
ccam shims install            # recreate missing links of all accounts
ccwork -p "summarise" --output-format json

ccam प्रत्येक बदलाची खात्री देते:

$ ccam shortcut work ccwork
✓ shortcut for work: ccwork
$ ccam shortcut work ccw
✓ shortcut for work: ccw (was ccwork)
$ ccam shortcut work --remove
✓ ccw removed; work has no shortcut now
$ ccam shortcut work
work: none (add one with `ccam shortcut work ccwork`)

एका खात्याला जास्तीत जास्त एक शॉर्टकट असतो, जो ~/.config/ccam/config.toml मध्ये shortcut म्हणून साठवला जातो. ccam add विझार्ड Create a shortcut command for <name>? [y/N] आणि मग Shortcut name [cc<name>]: विचारतो. विझार्डबाहेर, ccam add फक्त --shortcut सह शॉर्टकट तयार करते. ccam list प्रत्येक खात्याचा शॉर्टकट दाखवते, किंवा -.

शॉर्टकट प्रत्येक आर्ग्युमेंट Claude Code ला देतो, जसे ccam <name> नावानंतर करते. यात --dry-run आणि --help सुद्धा येतात: सुरू करण्याचे पूर्वावलोकन करण्यासाठी ccam --dry-run work वापरा.

पर्याय

ccam shims install कोणतेही आर्ग्युमेंट घेत नाही आणि --dry-run ccam: --dry-run is not supported by `ccam shims install`; nothing was changed देऊन नाकारते.

नावांचे नियम, या क्रमाने तपासले जातात:

• a-z, 0-9, ., - आणि _ यांपासून बनलेली 1 ते 64 अक्षरे, अक्षराने किंवा अंकाने सुरू होणारी;
• ccam, claude किंवा run किंवा usage सारखी ccam कमांड नाही;
• दुसऱ्या खात्याचा शॉर्टकट नाही;
• ~/.local/bin मधील अशी फाइल नाही जी आधीच ccam ची लिंक नाही;
• तुमच्या PATH वरील दुसऱ्या executable चे नाव नाही.

कमांड आणि --remove एकत्र दिल्यास give a command or --remove, not both ने थांबते. खात्याकडे आधीच असलेले नाव सेट केल्यास work: ccwork (unchanged) छापले जाते आणि लिंक नसल्यास ती पुन्हा तयार होते.

हे कसे काम करते

नाव सेट केल्यावर checkShortcut चालते, जे bin फोल्डर आणि ccam binary चा खरा पाथ देऊन shim.Check बोलावते:

नाव तपासण्यांमधून क्रमाने खाली जाते. प्रत्येक तपासणीशेजारी ती नाकारत असलेले एक नाव आहे: Work pattern मध्ये बसत नाही, run ही ccam कमांड आहे, ccside दुसऱ्या खात्याचे आहे, ccfile ही ~/.local/bin मधील आधीपासून असलेली फाइल आहे, आणि git /usr/bin/git लपवेल. प्रत्येक तपासणी पार करणारे नावच सेव्ह आणि लिंक होते.

1. shim.Check नाव ^[a-z0-9][a-z0-9._-]{0,63}$ शी, मग config.Reserved शी, मग cfg.FindShortcut शी जुळवते. ते ~/.local/bin/<name> वर os.Lstat बोलावते, आणि PATH वरील इतर प्रत्येक फोल्डरसाठी os.Stat बोलावून ccam ची लिंक नसलेली executable फाइल नाकारते.
2. ccam config.toml fsutil.AtomicWrite ने सेव्ह करते (तात्पुरती फाइल, fsync, rename).
3. shim.Remove जुन्या शॉर्टकटची लिंक हटवते, पण ती ccam ची लिंक असेल तरच.
4. shim.Install config मधील प्रत्येक शॉर्टकटची नसलेली लिंक os.Symlink ने ccam binary कडे तयार करते, जी os.Executable आणि filepath.EvalSymlinks ने शोधली जाते. ते कधीच काहीही काढत नाही.

os.Readlink ccam चा पाथ परत देते तेव्हा, किंवा लिंक आणि ccam चा पाथ एकाच फाइलकडे जातात तेव्हा, ती लिंक ccam ची स्वतःची मानली जाते. प्रत्येक remove आणि प्रत्येक overwrite तपासणी या चाचणीतून जाते, त्यामुळे ccam ने तयार न केलेल्या फाइल्सना ते हात लावत नाही.

तुम्ही शॉर्टकट चालवता तेव्हा, तुम्ही टाइप केलेले नाव हीच एक गोष्ट ccam ला लागते:

shell ला PATH वर ccwork सापडतो, kernel लिंक पाळून ccam binary सुरू करतो, आणि argv[0] तरीही ccwork असतो. app.Main मध्ये, ccam शिवाय इतर कोणतेही नाव config.toml एकदा लोड करते आणि shim.Lookup बोलावते, जे ज्या खात्याचा shortcut filepath.Base(argv[0]) शी जुळतो ते शोधते. मग launcher.LaunchWith आधीच लोड झालेल्या config सह ccam <name> सारखेच टप्पे घेते, आणि argv[1:] न बदलता claude ला देते.

shell alias किंवा wrapper script नाही तर symlink का: symlink प्रत्येक shell मध्ये आणि scripts मध्ये चालते, ती अतिरिक्त shell सुरू करण्याचा वेळ (सुमारे 1 ते 2 ms) जोडत नाही, आणि सुरू करताना तरीही एकच फाइल वाचली जाते. scripts/perf-check.sh hyperfine ने शॉर्टकट मोजते, ccam <name> च्याच 10 ms (p95) मर्यादेवर.

सुरक्षितता आणि अपवादात्मक स्थिती

• कोणत्याही खात्याची नसलेली लिंक. ~/.local/bin मधील ccam च्या लिंकचे नाव कोणतेही खाते वापरत नसेल, उदाहरणार्थ तुम्ही config.toml मधील shortcut हाताने बदलल्यानंतर, तर ccam डीफॉल्ट खात्यावर जात नाही. ते ccam: ccold is not the shortcut of any account (see `ccam list`, `ccam shortcut`) ने थांबते. ccam shortcut ने नाव पुन्हा सेट करा, किंवा लिंक हटवा.
• आधीपासून असलेल्या फाइल्स. ccam ने तयार न केलेली फाइल ते कधीच बदलत नाही. ccam shims install <path> already exists and is not a ccam link, so it was left alone ने थांबते.
• हलवलेली ccam binary. तेव्हा जुन्या लिंक्स आता अस्तित्वात नसलेल्या पाथकडे निर्देश करतात, आणि ccam त्यांना स्वतःच्या मानत नाही. त्या हटवा, मग ccam shims install चालवा.
• नाव बदलणे आणि काढणे. ccam rename शॉर्टकटचे नाव तेच ठेवते, आणि लिंक चालत राहते, कारण ती ccam कडे निर्देश करते आणि ccam config.toml मध्ये नाव शोधते. ccam remove खात्याची लिंक हटवते. ccam shortcut <account> <new> नवीन लिंक तयार करण्यापूर्वी जुनी हटवते.
• PATH. ccam लिंक तयार करते आणि ~/.local/bin तुमच्या PATH वर नसतो, तेव्हा ते Note: /home/me/.local/bin is not in PATH. Add it to ~/.bashrc or ~/.zshrc: आणि त्यानंतर जोडायची export PATH=... ओळ छापते.
• नंतर तपासणे. ccam doctor missing shortcuts in /home/me/.local/bin: ccwork नोंदवते आणि फोल्डर PATH वर नसल्यास इशारा देते. ccam doctor --fix नसलेल्या लिंक्स तयार करते.

संबंधित

• Claude Code सुरू करणे
• खाती व्यवस्थापित करणे
• कमांड संदर्भ
• ccam इन्स्टॉल करा