Reference

Configuration

One TOML file. Every setting has a default; write only what you change.

aki config init

This writes ~/.config/aki/config.toml with every setting at its default and a comment on each. aki config path prints where the file is. Unknown keys and names are errors.

Files

File	Holds
`~/.config/aki/config.toml`	The settings on this page. `$AKI_CONFIG` names another file; `$XDG_CONFIG_HOME` is honored.
`~/.config/aki/spaces.toml`	Your spaces, rewritten when you rearrange the board.
`~/.cache/aki/cache.db`	What was read from the sources (SQLite). `$XDG_CACHE_HOME` is honored.
`~/.local/state/aki/snoozed.json`	What you set aside. `$XDG_STATE_HOME` is honored.

General

refresh_seconds = 30
notifications = true
cache_seconds = 60

Key	Meaning
`refresh_seconds`	How often the board looks again. Minimum 5.
`notifications`	A desktop notification when something new becomes yours.
`cache_seconds`	`aki list` reuses a reading younger than this. `0`: always ask.

Sources

[[sources]]
kind = "gitlab"

[[sources]]
kind = "github"

[[sources]]
kind = "jira"
site = "https://your-company.atlassian.net"
email = "you@your-company.com"
token_env = "JIRA_API_TOKEN"

Every key is on Sources.

Rules

[threads]
who_resolves = "reviewer"
ignore_bots = true

[drafts]
mine = "todo"
others = "wait"

[re_review]
triggers = ["author_replied", "new_commits", "re_requested", "approval_reset"]
after_approval = false

[tickets]
waiting_statuses = ["blocked", "on hold", "in review", "waiting"]

[nudge]
after_days = 0

[rules.checks_running]
bucket = "todo"
priority = 45

Every key is on Rules.

Urgency

[urgency]
per_day = 3
waiting_cap = 60
linked = 5
highest = 50
high = 30
medium = 10
low = 0
lowest = -10
warm = 100
hot = 130

Every key is on Urgency.

Agent

[agent]
command = "claude {prompt}"
instructions = ""
launcher = "auto"
chat_url = "https://claude.ai/new?q={prompt}"
workspace = "{repo}"
tab = "{ticket} {ref}"
focus = true
# terminal = ["alacritty", "--title", "{title}", "-e", "{command}"]
# herdr_session = "work"
# tuios_session = "work"
# roots = ["~/code"]

# [agent.repos]
# "group/project" = "~/elsewhere/project"

Every key is on Agents.

Sounds

[sounds]
enabled = true
# new_task = "Glass"

# [sounds.rules]
# review_requested = "Ping"

Every key is on Set aside, be told.

Assistants

[mcp]
enabled = true
set_aside = true
start_agent = true

Every key is on Assistants.

PreviousSet aside, be told NextSources