Requirements
codehead runs every thread through axel. Install axel and create at least one agent first. axel’s own requirements (supported systems, harnesses) apply as is:
System
Section titled “System”- OS: Linux or macOS, x86_64 or arm64.
- git: for branches and worktrees.
- sqlite3: codehead reads axel’s thread database with the
sqlite3CLI. - Terminal: true color. The kitty keyboard protocol (kitty, Ghostty, WezTerm, foot, …) enables ⌘ shortcuts and undo / redo keys.
Optional
Section titled “Optional”- Clipboard (Linux):
wl-clipboardon Wayland,xcliporxselon X11. - Editor:
$VISUALor$EDITOR(defaultnvim, elsevi), to edit notes. - VS Code:
codeorcodium, to open a thread’s worktree withctrl+i.