Skip to content

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.

  • 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 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.