Faa Code

VS Code companion for faa, a local-first AI pair-programmer CLI. This extension does not run any AI itself — it streamlines getting context from the editor into a running faa terminal session, and surfaces the health of your local faa-services backend.

Features

Copy File Reference

Run Faa Code: Copy File Reference from the Command Palette (bind it to a key of your choice in Keyboard Shortcuts if you want one) to copy a file reference in the exact format faa parses, and (optionally) paste it straight into a faa terminal:

# Select lines 10-20 in src/main.rs, run the command
# Result: @[/Users/you/project/src/main.rs:10:20]

# No selection, just run the command
# Result: @[/Users/you/project/src/main.rs]

Right-click in the editor or in the file explorer for explicit Copy Absolute Path / Copy Relative Path commands under the Faa Code submenu, regardless of your configured default format.

Start New Session

Faa Code → Start New Session opens (or focuses) a dedicated terminal and launches faa in it.

Sync Workspace

Faa Code: Sync Workspace runs faa workspace sync --init for the current workspace folder, so semantic search stays up to date without leaving the editor.

Status Bar

A status bar item shows the health of your local faa-services instance (based on faa-services status), refreshed every minute. Click it to see the full status output.

Requirements

The faa CLI must be installed and available on your PATH (or point faa.binaryPath at it).
faa-services running locally for the status bar and semantic search features.

Configuration

Setting	Default	Description
`faa.binaryPath`	`faa`	Path to the faa executable.
`faa.servicesBinaryPath`	`faa-services`	Path to the faa-services executable, used for the status bar.
`faa.autoPaste`	`true`	Automatically paste copied file references into the terminal.
`faa.pasteDelay`	`5000`	Milliseconds to wait for a freshly opened terminal's `faa` session to start before auto-pasting.
`faa.openTerminal`	`once`	`once` opens and reuses a terminal for pasted references; `never` only copies to the clipboard.
`faa.fileReferenceFormat`	`absolute`	Path format used by the default Copy File Reference command.
`faa.notifications.info` / `.warning` / `.error`	`true`	Toggle notification levels shown by this extension.

License

MIT