Skip to content

Tasks

A task is what you write on the new tab before a thread starts: a title, a prompt, notes, agents and a place to work. Starting it creates an axel thread with that text as its first message.

  • @ lists agent names. > lists commands: files, notes, threads, artifacts and skills.
  • A path (src/, ./a/b, ~/x/) lists that directory as you type. tab inserts the row.
  • ctrl+v pastes a clipboard image as [Image #n]. Text over 256 characters becomes [Pasted text #n +L lines]. Both go into the message as attachments.
  • Markdown lists continue on enter.

The where row (← →) picks the branch:

  • the current branch (default): the thread works in place,
  • main or another branch (newest commit first),
  • a new branch in the main checkout,
  • a new branch with its own worktree (-b sets this).

Outside a git repository, the thread works in the current directory.

An unsent task is saved after every key to ~/.cache/codehead/drafts. The new tab shows view drafts (n) on top. A started thread drops its draft; drafts older than 30 days go.