id = "herdr"
name = "Herdr"
homepage = "https://herdr.dev"
description = "Agent multiplexer that lives in your terminal"
executables = ["herdr"]
[dotfiles]
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"]
