Check the daemon
Run shellclaw status. The expected response is shellclaw: running.
Install local Zsh autocomplete
ShellClaw currently supports Zsh on Apple Silicon Macs. Homebrew installs the binary, managed shell hook, local model, and background daemon.
Apple SiliconZshLocal model download
Three commands
The first install may take longer while ShellClaw measures Hugging Face and ModelScope, then downloads from the faster source.
Formula and source code are available in the official ShellClaw GitHub repository.
brew tap edwardd02/shellclawbrew trust edwardd02/shellclawbrew install shellclaw
Verify the first run
Open a new terminal after installation so Zsh loads the managed ShellClaw hook.
Start a command
Try typing git che. A completion may appear as gray text after the cursor.
Accept the suffix
Press Right Arrow. Tab remains exclusively available to your existing shell completion.
Common setup fixes
ShellClaw fails quietly during interactive use, so a daemon or model problem never blocks your input.
No suggestion appears
Confirm shellclaw status, then check that a GGUF model exists under ~/.shellclaw/models/. Open a fresh Zsh terminal after setup.
The model download stopped
Run brew postinstall shellclaw. The download resumes from its partial file and can switch sources.
Tab still accepts ShellClaw suggestions
Open a new terminal after upgrading so Zsh loads the new hook. Tab will then remain exclusively available to native completion.
Inspect before you install
The daemon, shell hooks, packaging scripts, and protocol types are open source.