# Gajerun umarni

> Ba asusu umarninsa kamar ccwork da ccam shortcut, kuma sake ƙirƙirar mahaɗai a ~/.local/bin da ccam shims install.

Source: https://ccam.dev/ha/features/shortcuts/ · Updated 2026-10-19

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

```sh
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:

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

| Zaɓi | Abin da yake yi | Tsoho |
| --- | --- | --- |
| `--remove` | Goge gajeren umarnin asusun da mahaɗinsa | a kashe |
| `-h`, `--help` | Taimako ga umarnin | |
| `--dry-run` | `ccam shortcut` yana karɓar sa: yana duba sunan kuma yana buga `Would set the shortcut of work to ccwork.` ko `Would remove ccwork, the shortcut of work.` ba tare da ajiyewa ko haɗawa ba | a kashe |

`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>`](https://ccam.dev/ha/features/launch.md) 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](https://ccam.dev/ha/features/launch.md)
- [Sarrafa asusai](https://ccam.dev/ha/features/accounts.md)
- [Bayanin umarnai](https://ccam.dev/ha/docs/commands.md#shortcuts)
- [Girka ccam](https://ccam.dev/ha/docs/install.md)