Zsh integration

Type : at the start of any prompt to talk to Faa, without leaving your shell.

Setup

faa zsh setup

This updates your ~/.zshrc to load the plugin. Restart your shell or run exec zsh to pick it up.

The plugin needs fd for file lookup. Install it with brew install fd (macOS), apt install fd-find (Debian/Ubuntu) or pacman -S fd (Arch).

What it gives you

Syntax	Effect
`:your prompt`	Send a prompt to Faa from the shell prompt
`:agent_name`	Switch agent — Tab completes available ones
`@[file]`	Tag a file into context; Tab opens a fuzzy picker

Commands and tagged files get syntax highlighting as you type, and consecutive commands stay in the same conversation instead of starting a fresh one each time.

Check the setup

faa zsh doctor

Reports what's missing — plugin not loaded, fd absent, faa not on PATH, and so on.

Details

The plugin source lives in shell-plugin/; its README covers configuration, key bindings and the theme in full.