CLI
codehead [-a agent[,agent…]] [-b branch] [-c] [-n] [title...]codehead --view <thread>codehead --cost <thread>codehead --versioncodehead --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 |
Environment
Section titled “Environment”| 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) |