Skip to content

CLI

codehead [-a agent[,agent…]] [-b branch] [-c] [-n] [title...]
codehead --view <thread>
codehead --cost <thread>
codehead --version
codehead --update
Option Effect
-a agent[,agent…] agents preselected for the new thread (default: the default agent)
-b branch branch for a new worktree (default: <prefix>/<title slug>)
-c copy the picked note paths to the clipboard, start nothing
-n dry run: print the axel command, start nothing
title... prefills the title
--view <thread> open the thread view of a thread
--cost <thread> the cost pane of a thread (the thread view starts it)
-V, --version print the version
--update install the latest release with the install script
-h, --help full help, with every key
Variable Effect
CODEHEAD_CONFIG config file path (default ~/.config/codehead.toml)
CODEHEAD_NOTES, CODEHEAD_STYLES, CODEHEAD_AGENT, CODEHEAD_PREFIX, CODEHEAD_MODELS override the config keys
CODEHEAD_DRAFTS drafts folder (default ~/.cache/codehead/drafts)
CODEHEAD_VSCODE VS Code binary for ctrl+i
CODEHEAD_NO_UPDATE_CHECK 1: no daily release check
CODEHEAD_KEYLOG file: log every key of the text inputs
CODEHEAD_INSTALL_DIR install script target (default ~/.local/bin)