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 Ctrl+Space. Tab and the arrow keys remain available to existing shell bindings.
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.
Ctrl+Space changes the input method
Remove or change the conflicting macOS or terminal shortcut so the terminal can send ^@ to Zsh.
Inspect before you install
The daemon, shell hooks, packaging scripts, and protocol types are open source.