Terminal

All of AFH.
In your terminal.

The same agent as the desktop app, full screen in any terminal. Threads, models, approvals, goals, helpers, every setting. It runs on its own: no desktop app needed.

Then go to a project folder and type afh. Windows, Mac and 64-bit Linux. No admin rights needed.

AFH in a terminal: threads on the left, a strand running down the conversation into the animated AFH mark at the message box

Its own design

A terminal app that looks like AFH.

The mark from the app, drawn in your terminal, flowing while it works. The conversation runs down a strand, every step a point on it, and joins the message box. During a run, light travels along it.

AFH's start screen in a terminal: the mark, with its three strands leading to the project, the model and what's next

The same AFH

Not a smaller version.

It talks to the same engine as the desktop app, and shares its threads, settings, providers and keys. If the app is open, the terminal connects to it, and you can watch the same thread in both.

The slash command menu in AFH's terminal app
Type / for every command
An approval sheet with a diff in AFH's terminal app
Approve edits and commands, with the diff
Settings in AFH's terminal app
All 18 sections of Settings
The command palette in AFH's terminal app
Ctrl+P finds any action, thread, model or theme

Keys

EnterSend
Ctrl+JNew line
EscStop the run
Esc EscUndo, from an empty box
TabNext agent: Build, Plan, Delegate, Red Team
Shift+TabApprovals: ask first, full access, read only
Ctrl+PCommand palette
Ctrl+KThreads
Ctrl+NNew thread
F2Settings
F3Threads rail
Ctrl+OOpen or close tool details
Ctrl+BLive panel
Ctrl+RSearch what you've sent
Ctrl+GWrite in your editor
Ctrl+CClear the box. Twice: quit

Commands

/model, /agent, /modeWhat runs, and how freely
/connectSign in or add a key
/threadsOpen, rename, fork, export, delete
/goal, /todoLong work, step by step
/undo, /redoRewind the thread and its files
/diff, /costWhat changed, and what it took
/context, /promptSee and edit what the model sees
/memory, /compactWhat it knows, and room to work
/helpers, /jobsWatch helpers and background jobs
/worktree, /raceBranches, and models against each other
/theme67 themes, the same as the app
/settingsEverything else

Your own commands, like /review, show up here too. Type @ to pick a file and ! to run a shell command the agent can see.

In scripts

One task, then exit.

afh run prints the answer to stdout and takes piped input, for scripts and CI. Read the guide →

afh run "fix the failing tests"One task
git diff | afh run "review this" -qPiped input, answer only
afh run --json "..."Every event as JSON lines
afh updateInstall the newest version
afh uninstallRemove it; your threads and keys stay
afh --plainA simple line chat for basic terminals

Questions

Good to know.

Which terminals work?

Windows Terminal, the terminal in VS Code, macOS Terminal, iTerm2 and modern Linux terminals. The old Windows console window works but shows fewer colors. In a very basic terminal or a pipe, afh uses a simple line chat.

What can't a terminal do?

It can't draw images or embed a browser, so screenshots and design previews open in your own viewer and browser. The mic is in the desktop and phone apps. The rest is here.

Why does my antivirus question it?

AFH isn't code-signed yet, so some antivirus programs are wary of new builds. The installer checks the SHA-256 of every download against the release.

Can I read the script first?

Yes: install.ps1 and install.sh. They download a release from GitHub, check it, unpack it to the .afh folder in your home folder and add afh to your PATH. Nothing needs admin rights.

Three ways.
One AFH.

Prefer a window? The desktop app is the same AFH.