id          = "herdr"
name        = "Herdr"
homepage    = "https://herdr.dev"
description = "Agent multiplexer that lives in your terminal"
executables      = ["herdr"]

[dotfiles]

# https://herdr.dev/docs/configuration/ documents the stable global config as
# ~/.config/herdr/config.toml on macOS/Linux and %APPDATA%\\herdr\\config.toml
# on Windows. Logs and session state in the same directory are generated state,
# not user configuration, so only config.toml is listed.
paths = [
  "[configHome]/herdr/config.toml",
  "%APPDATA%/herdr/config.toml",
]
secret = []

[commands]
format = 1
label = "Launch workspace"
description = "Launch or attach to a Herdr session, locally or over SSH. Subcommands (workspace, pane, tab, agent, api ...) are outside this form."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
revision = "0.7.5"
evidence = """
Usage: herdr [options]
       herdr --session <name> [options]
       herdr --remote <ssh-target> [--session <name>]
Options:
  --no-session        Run monolithically (no server/client, escape hatch)
  --session <name>    Use or create a named persistent session
  --remote <target>   Attach through SSH to a remote Herdr server
  --remote-keybindings <local|server>
                      Keybindings for --remote app attach (default: local)
"""

[[commands.field]]
id = "session"
label = "Session name"
description = "Use or create a named persistent session."
type = "string"
option = ["--session"]
sources = ["help"]

[[commands.field]]
id = "remote"
label = "Remote SSH target"
description = "Attach through SSH to a remote Herdr server."
type = "string"
option = ["--remote"]
sources = ["help"]

[[commands.field]]
id = "remote_keybindings"
label = "Remote keybindings"
type = "enum"
option = ["--remote-keybindings"]
choices = [{ value = "local", label = "Local" }, { value = "server", label = "Server" }]
sources = ["help"]

[[commands.field]]
id = "no_session"
label = "Run without a server"
description = "Run monolithically (no server/client)."
type = "boolean"
option = ["--no-session"]
sources = ["help"]

[[commands.task]]
id = "named"
label = "Named session"
fields = ["session"]
required = ["session"]

[[commands.task]]
id = "remote"
label = "Attach to remote"
fields = ["remote", "session", "remote_keybindings"]
required = ["remote"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["session", "remote", "remote_keybindings", "no_session"]