Configuration

Nothing is required. ~/.hum/config.toml is yours; <repo>/.hum/config.toml is the project's.

config.toml

[model]
name = "kimi-k3"             # a route from /model, or provider/model
# reasoning_effort = "high"  # low | medium | high; the server sends high unless you set this
# agents = "..."             # route for sub-agents
# api_base = "https://..."   # any OpenAI-compatible endpoint; with api_key_env, context_window

[[mcp]]
name = "jira"
url = "https://.../mcp"      # or command = "npx", args = ["jira-mcp"]

[policy]
gate = "off"                 # off | approve
compact_at_tokens = 200000

[permissions]
allow = []
ask = []
deny = []

[hooks]
enabled = true
foreign = true               # run Claude Code and Codex hook files

[sandbox]
mode = "workspace"           # workspace | required | off
network = false
writable = []
env_pass = []

[sync]
world = true                 # send the working tree's history with each turn

[session]
delivery_question = true     # ask whether you would merge an exchange that wrote files

[ui]
reasoning = true             # stream the model's thinking

[notify]
desktop = true

Files

Environment variables