config.example.toml

# Agentctl config — copy to ~/.config/agentctl/config.toml and edit (`agentctl config --setup`).

# Optional. Which tool's launcher is primary (informational).
default_tool = "claude"

# ─── dir groups ──────────────────────────────────────────────────────────────
# Each group is a section in the New screen. `path` is scanned one level deep for
# project dirs, sorted by `z` frecency (falls back to mtime). ~ and $HOME expand.
[[group]]
name  = "Frontend"
path  = "~/code/frontend"
color = "#6C91BF"

[[group]]
name  = "Backend"
path  = "~/code/backend"
color = "#A855F7"

# ─── tools ───────────────────────────────────────────────────────────────────
# Each tool generates a launcher command named `name`. `runs` is a shell command
# executed in the chosen dir. Adding/removing a tool takes effect in a NEW shell.
[[tool]]
name  = "claude"
runs  = "claude --dangerously-skip-permissions"
label = " ⚡ Projects "
color = "#6C91BF"

[[tool]]
name  = "cdx"
runs  = "codex --dangerously-bypass-approvals-and-sandbox"
label = " ✦ Codex "
color = "#A855F7"

# Several Claude accounts on one machine? Each lives in its own CLAUDE_CONFIG_DIR. `runs` goes
# through the shell, so an env prefix is all it takes — add one tool per profile and cycle them
# with ⇧⇥. Resume already picks the right profile on its own.
# [[tool]]
# name  = "work"
# runs  = "CLAUDE_CONFIG_DIR=~/.claude2 claude --dangerously-skip-permissions"
# label = " ⚡ Work account "
# color = "#4EA37A"

# ─── IDEs ────────────────────────────────────────────────────────────────────
# Each IDE binds an fzf-style ctrl-key: opens the editor, then launches the tool.
# `cmd` is run via the shell with $dir = the selected absolute path.
# Reserved keys (cannot be used): ctrl-f ctrl-p ctrl-t ctrl-n (and enter).
[[ide]]
key   = "ctrl-v"
label = "code"
cmd   = 'code "$dir"'

[[ide]]
key   = "ctrl-r"
label = "rider"
cmd   = 'open -a "Rider" "$dir"'

[[ide]]
key   = "ctrl-b"
label = "both"
cmd   = 'code "$dir"; open -a "Rider" "$dir"'

# ─── GUI / terminal ──────────────────────────────────────────────────────────
# Which terminal the GUI opens sessions in.
#   "default"  → the system default terminal (whatever opens .command files)
#   an app name → "Terminal" | "iTerm" | "Ghostty" | "Warp" | "kitty" | "WezTerm" | "cmux"
#   "custom"   → set launch_command with {{script}} (temp .command path), {{cmd}}, or {{dir}}
[gui]
terminal = "default"
# launch_command = 'open -a "iTerm" {{script}}'

# Global keyboard shortcut to open the GUI window (Mac GUI only).
# Modifiers: cmd / shift / ctrl / alt (option) + one key. Empty/omitted = off.
# hotkey = "cmd+shift+m"

# ─── theme (optional) ────────────────────────────────────────────────────────
# [theme]
# accent = "#FF9F43"