Skip to content

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:

  • OS: Linux or macOS, x86_64 or arm64.
  • git: for branches and worktrees.
  • sqlite3: codehead reads axel’s thread database with the sqlite3 CLI.
  • Terminal: true color. The kitty keyboard protocol (kitty, Ghostty, WezTerm, foot, …) enables ⌘ shortcuts and undo / redo keys.
  • Clipboard (Linux): wl-clipboard on Wayland, xclip or xsel on X11.
  • Editor: $VISUAL or $EDITOR (default nvim, else vi), to edit notes.
  • VS Code: code or codium, to open a thread’s worktree with ctrl+i.