Gajerun umarni

Gajeren umarni umarni ne da kai da kanka ka sa masa suna, wanda ke fara Claude Code a matsayin asusu ɗaya: ccwork --resume yana yin abin da ccam work --resume ke yi. Mahaɗi ne zuwa ccam a cikin ~/.local/bin, don haka yana aiki a bash, zsh, rubutun (scripts) da duk wani abu da ke gudanar da shirye-shirye daga PATH. Gajerun umarni zaɓi ne; ƙirƙiri ɗaya ga asusan da kake farawa sau da yawa.

Amfani

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 yana tabbatar da kowane canji:

$ 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`)

Asusu yana da gajeren umarni ɗaya a mafi yawa, wanda aka ajiye a matsayin shortcut a ~/.config/ccam/config.toml. Mataimakin ccam add yana tambaya Create a shortcut command for <name>? [y/N] sannan Shortcut name [cc<name>]:. A wajen mataimakin, ccam add yana ƙirƙirar ɗaya ne kawai da --shortcut. ccam list yana nuna gajeren umarnin kowane asusu, ko -.

Gajeren umarni yana miƙa kowane argument ga Claude Code, kamar yadda ccam <name> ke yi bayan sunan. Wannan ya haɗa da --dry-run da --help: don duba farawa kafin lokaci, yi amfani da ccam --dry-run work.

Zaɓuɓɓuka

ccam shims install ba ya karɓar arguments kuma yana ƙin --dry-run da ccam: --dry-run is not supported by `ccam shims install`; nothing was changed.

Ƙa'idodin suna, ana duba su a wannan tsari:

• haruffa 1 zuwa 64 na a-z, 0-9, ., - da _, suna farawa da harafi ko lamba;
• ba ccam, claude ko umarnin ccam kamar run ko usage ba;
• ba gajeren umarnin wani asusu ba;
• ba fayil a ~/.local/bin wanda ba mahaɗi zuwa ccam ba ne tuni;
• ba sunan wani shiri a PATH naka ba.

Ba da umarni da --remove tare yana tsayawa da give a command or --remove, not both. Saita sunan da asusu ya riga yana da shi yana buga work: ccwork (unchanged) kuma yana sake ƙirƙirar mahaɗinsa idan ya ɓace.

Yadda yake aiki

Saita suna yana gudanar da checkShortcut, wanda ke kiran shim.Check tare da foldar bin da ainihin hanyar binary na ccam:

Sunan yana sauka ta dubawar a tsari. Kusa da kowane dubawa akwai sunan da yake ƙi: Work ya gaza tsarin, run umarnin ccam ne, ccside na wani asusu ne, ccfile fayil ne da ke akwai a ~/.local/bin, kuma git zai ɓoye /usr/bin/git. Sunan da ya wuce kowane dubawa ne kawai ake ajiyewa da haɗawa.

1. shim.Check yana kwatanta sunan da ^[a-z0-9][a-z0-9._-]{0,63}$, sannan config.Reserved, sannan cfg.FindShortcut. Yana kiran os.Lstat a kan ~/.local/bin/<name>, kuma ga kowace foldar dabam a PATH yana kiran os.Stat kuma yana ƙin fayil mai gudana (executable) wanda ba mahaɗi zuwa ccam ba ne.
2. ccam yana ajiye config.toml da fsutil.AtomicWrite (fayil na wucin gadi, fsync, rename).
3. shim.Remove yana goge mahaɗin tsohon gajeren umarnin, amma sai idan mahaɗi ne zuwa ccam.
4. shim.Install yana ƙirƙirar mahaɗin kowane gajeren umarni da aka saita wanda ya ɓace, da os.Symlink zuwa binary na ccam, wanda aka nemo da os.Executable da filepath.EvalSymlinks. Ba ya taɓa cire komai.

Ana ɗaukar mahaɗi a matsayin na ccam idan os.Readlink ya mayar da hanyar ccam, ko idan mahaɗin da hanyar ccam suna kai wa fayil ɗaya. Kowace cirewa da kowane dubawar maye gurbi suna bin wannan gwaji, don haka ccam ba ya taɓa fayilolin da bai ƙirƙira ba.

Idan ka gudanar da gajeren umarni, sunan da ka rubuta shi ne kawai abin da ccam ke buƙata:

Shell yana samun ccwork a PATH, kernel yana bin mahaɗin kuma yana fara binary na ccam, kuma argv[0] har yanzu ccwork ne. A app.Main, duk sunan da ba ccam ba yana loda config.toml sau ɗaya kuma yana kiran shim.Lookup, wanda ke nemo asusun da shortcut ɗinsa ya yi daidai da filepath.Base(argv[0]). Sannan launcher.LaunchWith yana bin matakai iri ɗaya da ccam <name> da saitin da aka riga aka loda, kuma yana miƙa argv[1:] ga claude ba tare da taɓawa ba.

Me ya sa symlink ba alias na shell ko rubutun naɗewa (wrapper script) ba: symlink yana aiki a kowane shell da a rubutun, ba ya ƙara farawar shell (kusan 1 zuwa 2 ms), kuma farawar har yanzu tana karanta fayil ɗaya. scripts/perf-check.sh yana auna gajeren umarni da hyperfine a kan iyakar 10 ms (p95) ɗaya da ccam <name>.

Tsaro da yanayi na musamman

• Mahaɗin da babu asusun da ke da shi. Idan mahaɗi zuwa ccam a ~/.local/bin yana da sunan da babu asusun da ke amfani da shi, misali bayan ka gyara shortcut a config.toml da hannu, ccam ba ya komawa ga asusun tsoho. Yana tsayawa da ccam: ccold is not the shortcut of any account (see `ccam list`, `ccam shortcut`). Sake saita sunan da ccam shortcut, ko goge mahaɗin.
• Fayilolin da ke akwai. ccam ba ya taɓa maye gurbin fayil da bai ƙirƙira ba. ccam shims install yana tsayawa da <path> already exists and is not a ccam link, so it was left alone.
• Binary na ccam da aka matsar. Tsofaffin mahaɗai sai su nuna hanyar da babu ita kuma, kuma ccam ba ya ɗaukar su a matsayin nasa. Goge su, sannan gudanar da ccam shims install.
• Sake suna da cirewa. ccam rename yana riƙe sunan gajeren umarnin, kuma mahaɗin yana ci gaba da aiki, domin yana nuna ccam kuma ccam yana neman sunan a config.toml. ccam remove yana goge mahaɗin asusun. ccam shortcut <account> <new> yana goge tsohon mahaɗin kafin ya ƙirƙiri sabon.
• PATH. Idan ccam ya ƙirƙiri mahaɗi kuma ~/.local/bin ba ya cikin PATH naka, yana buga Note: /home/me/.local/bin is not in PATH. Add it to ~/.bashrc or ~/.zshrc: sannan layin export PATH=... da za a ƙara.
• Dubawa daga baya. ccam doctor yana bayar da rahoton missing shortcuts in /home/me/.local/bin: ccwork kuma yana gargaɗi idan foldar ba ta cikin PATH. ccam doctor --fix yana ƙirƙirar mahaɗan da suka ɓace.

Masu alaƙa

• Fara Claude Code
• Sarrafa asusai
• Bayanin umarnai
• Girka ccam