Skip to content

Configuration

codehead reads ~/.config/codehead.toml ($CODEHEAD_CONFIG overrides the path). Per key, the environment variable wins over the file, the file over the default. The settings tab edits the same file: ctrl+s saves, ctrl+r reloads.

notes = "~/notes" # $CODEHEAD_NOTES
styles = "~/styles" # $CODEHEAD_STYLES
agent = "amon" # $CODEHEAD_AGENT
prefix = "task" # $CODEHEAD_PREFIX
models = "fable,opus,sonnet,haiku" # $CODEHEAD_MODELS
[aliases]
"project:platform" = "~/projects/exampleorg/project/notes/platform/"
Key Default Meaning
notes notes/ of the app dir notes root
styles output-styles/ of the app dir output styles folder
agent amon, else the first axel agent default agent
prefix task branch prefix for new branches
models fable,opus,sonnet,haiku Claude models in the agent form
[aliases] none short names for directories, see aliases
Path Content
~/.cache/codehead/drafts unsent tasks
~/.cache/codehead/history prompt history per thread
~/.cache/codehead/handoff handoff files for replaced agents
~/.cache/codehead/seen.json unread state of the thread header
~/.cache/codehead/release daily update check cache
~/.axel/logs/codehead-*.log logs of the threads codehead starts