Skip to content

Quick start

  1. Install axel and create an agent (axel quick start):

    Terminal window
    axel agent new amon claude/opus
  2. Install codehead:

    Terminal window
    curl -fsSL https://codehead.sh/install | sh
  3. Start it in a git repository:

    Terminal window
    cd ~/projects/my-app
    codehead
  4. Type a title, then write the task in the prompt. @ lists agents, > lists commands, tab moves between fields.

  5. Pick where the work runs in the where row (← →): the current branch, another branch, a new branch, or a new branch with its own worktree.

  6. Start the thread. codehead hands the terminal to the thread view: the agent’s stream on top, your prompt below. Send with ctrl+enter.

esc esc goes back to the start screen. The thread keeps running in axel: open it again from the threads tab, or with axel thread open.