Introduction
codehead is a terminal app for starting and following agent work. You pick notes, write the task, choose agents and a branch, and codehead hands the terminal to an axel thread.
What codehead does
Section titled “What codehead does”- Task form: title, prompt, notes from your notes folder, agents, branch or worktree.
- Thread view: the agent stream, your prompt and the thread cost in one terminal.
- Threads tab: worktrees, open threads and recent Claude Code sessions to continue.
- Agents tab: create and edit agents, with a sprite, harness, model and output style.
- Settings tab: notes root, default agent, branch prefix and path aliases.
codehead and axel
Section titled “codehead and axel”codehead is built on axel.md. The split:
| axel owns | codehead owns |
|---|---|
| threads, agents, keys, sessions, policies | the task form, notes, drafts, the thread view |
| harness adapters (Claude Code, Codex, …) | agent sprites, output styles, the cost pane |
| the signed event log, remote hosts | the terminal UI around axel thread stream and compose |
Everything you do in codehead is plain axel underneath. You can drop to the axel CLI at any
time, and every axel concept in the axel docs applies as is.