id       = "aoe"
name     = "Agent of Empires"
homepage = "https://github.com/agent-of-empires/agent-of-empires"
executables   = ["aoe"]

[dotfiles]

# AoE documents a legacy macOS global config at ~/.agent-of-empires/config.toml
# and an XDG global config at $XDG_CONFIG_HOME/agent-of-empires/config.toml
# (default ~/.config). Profile overrides use profiles/<name>/config.toml in
# either location. Runtime state, logs, sessions, and trust decisions are not
# settings and are not listed.
# https://github.com/agent-of-empires/agent-of-empires/blob/main/docs/guides/configuration.md
paths = [
  "~/.agent-of-empires/config.toml",
  "~/.agent-of-empires/profiles/*/config.toml",
  "[configHome]/agent-of-empires/config.toml",
  "[configHome]/agent-of-empires/profiles/*/config.toml",
]
exclude = []
secret = []

[commands]
format = 1
label = "Agent of Empires"
description = "Create a coding-agent session. Sandbox, multi-repo workspace and structured-view options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.subcommand]]
path = ["add"]
label = "Add a session"

[[commands.subcommand.source]]
id = "src"
kind = "help"
url = "https://github.com/agent-of-empires/agent-of-empires/blob/main/src/cli/add.rs"
evidence = """
aoe add --cmd claude         # Create a session running Claude Code
    /// Project directory (defaults to current directory). Omit when
    /// using `--scratch`.
    /// Session title (defaults to folder name)
    #[arg(short = 't', long)]
    /// Command to run (e.g., 'claude' or any other supported agent)
    #[arg(short = 'c', long = "cmd")]
    /// Create session in a git worktree for the specified branch
    #[arg(short = 'w', long = "worktree")]
    /// Create a new branch (use with --worktree)
    #[arg(short = 'b', long = "new-branch")]
    /// Branch to base the new worktree branch on (use with --new-branch).
    #[arg(long = "base-branch")]
    /// name (use with --worktree). Outranks `--base-branch`, which
    /// Automatically trust this repository's hooks and project-local MCP
    #[arg(long = "trust-hooks")]
    Or re-run with --trust-hooks, or use the terminal view
    /// Launch the session immediately after creating
    #[arg(short = 'l', long)]
    launch: bool,
    (--launch is a no-op for structured view sessions;
    is given. Requires an interactive terminal. Ignored when --title is given.
"""

[[commands.subcommand.field]]
id = "path"
label = "Project directory"
description = "Defaults to the current directory."
type = "path"
position = 0
path = { kind = "directory", role = "input" }
sources = ["src"]

[[commands.subcommand.field]]
id = "title"
label = "Title"
description = "Defaults to the folder name."
type = "string"
option = ["--title"]
sources = ["src"]

[[commands.subcommand.field]]
id = "cmd"
label = "Agent command"
type = "string"
option = ["--cmd", "-c"]
suggestions = [{ value = "claude", label = "Claude Code" }]
sources = ["src"]

[[commands.subcommand.field]]
id = "worktree"
label = "Worktree branch"
type = "string"
option = ["--worktree", "-w"]
sources = ["src"]

[[commands.subcommand.field]]
id = "new_branch"
label = "Create new branch"
description = "Use together with a worktree branch."
type = "boolean"
option = ["--new-branch", "-b"]
sources = ["src"]

[[commands.subcommand.field]]
id = "base_branch"
label = "Base branch"
type = "string"
option = ["--base-branch"]
sources = ["src"]

[[commands.subcommand.field]]
id = "trust_hooks"
label = "Trust repository hooks"
type = "boolean"
option = ["--trust-hooks"]
effect = "exec"
sources = ["src"]

[[commands.subcommand.field]]
id = "launch"
label = "Launch immediately"
type = "boolean"
option = ["--launch", "-l"]
sources = ["src"]

[[commands.subcommand.task]]
id = "session"
label = "New session"
fields = ["path", "title", "cmd", "launch"]
required = []

[[commands.subcommand.task]]
id = "worktree"
label = "Session in a new worktree"
set = { new_branch = [true] }
fields = ["path", "title", "cmd", "worktree", "new_branch", "base_branch", "launch"]
required = ["worktree"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["path", "title", "cmd", "launch"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["worktree", "new_branch", "base_branch", "trust_hooks"]