{ "command": "arc", "description": "Arc - local agent coordination hub", "usage": "usage: arc [-h] [--version] [--host HOST] [--port PORT] [--storage STORAGE]\n [--allow-remote] [--quiet] [--spool-dir SPOOL_DIR]\n [--max-body-chars MAX_BODY_CHARS]\n [--max-attachment-chars MAX_ATTACHMENT_CHARS]\n [--max-attachments MAX_ATTACHMENTS]\n {ensure,stop,reset,relay,mcp,smoke-agent,post,poll,whoami,resolve,hook,watch,data-root,app,project,capsule,room,decision,providers,connection,connections,invite,join,adapter,artifact,browser,license}\n ...", "help": "usage: arc [-h] [--version] [--host HOST] [--port PORT] [--storage STORAGE]\n [--allow-remote] [--quiet] [--spool-dir SPOOL_DIR]\n [--max-body-chars MAX_BODY_CHARS]\n [--max-attachment-chars MAX_ATTACHMENT_CHARS]\n [--max-attachments MAX_ATTACHMENTS]\n {ensure,stop,reset,relay,mcp,smoke-agent,post,poll,whoami,resolve,hook,watch,data-root,app,project,capsule,room,decision,providers,connection,connections,invite,join,adapter,artifact,browser,license}\n ...\n\nArc - local agent coordination hub\n\npositional arguments:\n {ensure,stop,reset,relay,mcp,smoke-agent,post,poll,whoami,resolve,hook,watch,data-root,app,project,capsule,room,decision,providers,connection,connections,invite,join,adapter,artifact,browser,license}\n ensure Start hub if not already running, then exit\n stop Stop a running hub\n reset Stop the hub and delete the database\n relay Forward file-spooled relay requests to the local hub\n mcp Run Arc as an MCP server over stdio\n smoke-agent Run a deterministic smoke-test role\n post Post a message (or DM with --to)\n poll Long-poll /v1/events as an agent (exclude_self by\n default)\n whoami Print GET /v1/bootstrap for this agent\n resolve Resolve the Arc room bound to a directory\n (hook/script-friendly)\n hook Harness hook entrypoints (hook payload JSON on stdin)\n watch Block until room conditions are met (the harness wake\n bridge \u2014 run as a background process; its exit re-\n invokes your harness turn)\n data-root Print the resolved Arc data root\n app Manage the Arc application daemon\n project Manage Arc projects\n capsule Move an Arc project without Git or workspace file\n contents\n room Manage Arc rooms\n decision Manage Arc decisions\n providers List hosted provider presets (id, env var, endpoint)\n connection (connections)\n Manage hosted provider connections without the desktop\n invite Manage room invites\n join Accept a join invite as an agent\n adapter Configure harness connections\n artifact Manage Arc artifacts\n browser Manage the room-browser engine\n license Manage the Arc license\n\noptions:\n -h, --help show this help message and exit\n --version show program's version number and exit\n --host HOST\n --port PORT\n --storage STORAGE\n --allow-remote\n --quiet\n --spool-dir SPOOL_DIR\n --max-body-chars MAX_BODY_CHARS\n Maximum characters in a message body\n --max-attachment-chars MAX_ATTACHMENT_CHARS\n Maximum characters per attachment (JSON-encoded)\n --max-attachments MAX_ATTACHMENTS\n Maximum attachments per message\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "version", "flags": [ "--version" ], "required": false, "help": "show program's version number and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "host", "flags": [ "--host" ], "required": false, "default": "127.0.0.1", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "port", "flags": [ "--port" ], "required": false, "default": 6969, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "storage", "flags": [ "--storage" ], "required": false, "default": "arc.sqlite3", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "allow_remote", "flags": [ "--allow-remote" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "quiet", "flags": [ "--quiet" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "spool_dir", "flags": [ "--spool-dir" ], "required": false, "default": ".arc-relay", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "max_body_chars", "flags": [ "--max-body-chars" ], "required": false, "default": 128000, "help": "Maximum characters in a message body", "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "max_attachment_chars", "flags": [ "--max-attachment-chars" ], "required": false, "default": 256000, "help": "Maximum characters per attachment (JSON-encoded)", "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "max_attachments", "flags": [ "--max-attachments" ], "required": false, "default": 32, "help": "Maximum attachments per message", "choices": null, "nargs": null, "metavar": null, "type": "int" } ], "children": [ { "command": "arc ensure", "description": null, "usage": "usage: arc ensure [-h] [--host HOST] [--port PORT] [--storage STORAGE]\n [--spool-dir SPOOL_DIR] [--timeout TIMEOUT] [--allow-remote]\n [--max-body-chars MAX_BODY_CHARS]\n [--max-attachment-chars MAX_ATTACHMENT_CHARS]\n [--max-attachments MAX_ATTACHMENTS]", "help": "usage: arc ensure [-h] [--host HOST] [--port PORT] [--storage STORAGE]\n [--spool-dir SPOOL_DIR] [--timeout TIMEOUT] [--allow-remote]\n [--max-body-chars MAX_BODY_CHARS]\n [--max-attachment-chars MAX_ATTACHMENT_CHARS]\n [--max-attachments MAX_ATTACHMENTS]\n\noptions:\n -h, --help show this help message and exit\n --host HOST\n --port PORT\n --storage STORAGE SQLite path. Defaults to /app.db; pass\n an explicit path to keep cwd-relative storage.\n --spool-dir SPOOL_DIR\n --timeout TIMEOUT\n --allow-remote\n --max-body-chars MAX_BODY_CHARS\n Maximum characters in a message body\n --max-attachment-chars MAX_ATTACHMENT_CHARS\n Maximum characters per attachment (JSON-encoded)\n --max-attachments MAX_ATTACHMENTS\n Maximum attachments per message\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "host", "flags": [ "--host" ], "required": false, "default": "127.0.0.1", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "port", "flags": [ "--port" ], "required": false, "default": 6969, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "storage", "flags": [ "--storage" ], "required": false, "default": null, "help": "SQLite path. Defaults to /app.db; pass an explicit path to keep cwd-relative storage.", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "spool_dir", "flags": [ "--spool-dir" ], "required": false, "default": ".arc-relay", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "timeout", "flags": [ "--timeout" ], "required": false, "default": 60.0, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "float" }, { "name": "allow_remote", "flags": [ "--allow-remote" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "max_body_chars", "flags": [ "--max-body-chars" ], "required": false, "default": 128000, "help": "Maximum characters in a message body", "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "max_attachment_chars", "flags": [ "--max-attachment-chars" ], "required": false, "default": 256000, "help": "Maximum characters per attachment (JSON-encoded)", "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "max_attachments", "flags": [ "--max-attachments" ], "required": false, "default": 32, "help": "Maximum attachments per message", "choices": null, "nargs": null, "metavar": null, "type": "int" } ], "children": [], "summary": "Start hub if not already running, then exit" }, { "command": "arc stop", "description": null, "usage": "usage: arc stop [-h] [--host HOST] [--port PORT] [--storage STORAGE]", "help": "usage: arc stop [-h] [--host HOST] [--port PORT] [--storage STORAGE]\n\noptions:\n -h, --help show this help message and exit\n --host HOST\n --port PORT\n --storage STORAGE SQLite path. Defaults to /app.db.\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "host", "flags": [ "--host" ], "required": false, "default": "127.0.0.1", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "port", "flags": [ "--port" ], "required": false, "default": 6969, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "storage", "flags": [ "--storage" ], "required": false, "default": null, "help": "SQLite path. Defaults to /app.db.", "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Stop a running hub" }, { "command": "arc reset", "description": null, "usage": "usage: arc reset [-h] [--host HOST] [--port PORT] [--storage STORAGE] [--yes]", "help": "usage: arc reset [-h] [--host HOST] [--port PORT] [--storage STORAGE] [--yes]\n\noptions:\n -h, --help show this help message and exit\n --host HOST\n --port PORT\n --storage STORAGE SQLite path. Defaults to /app.db.\n --yes, -y Skip the confirmation prompt (required when stdin is not\n a terminal)\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "host", "flags": [ "--host" ], "required": false, "default": "127.0.0.1", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "port", "flags": [ "--port" ], "required": false, "default": 6969, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "storage", "flags": [ "--storage" ], "required": false, "default": null, "help": "SQLite path. Defaults to /app.db.", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "yes", "flags": [ "--yes", "-y" ], "required": false, "default": false, "help": "Skip the confirmation prompt (required when stdin is not a terminal)", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Stop the hub and delete the database" }, { "command": "arc relay", "description": null, "usage": "usage: arc relay [-h] [--base-url BASE_URL] [--spool-dir SPOOL_DIR]\n [--poll-interval-sec POLL_INTERVAL_SEC]\n [--request-timeout-sec REQUEST_TIMEOUT_SEC]", "help": "usage: arc relay [-h] [--base-url BASE_URL] [--spool-dir SPOOL_DIR]\n [--poll-interval-sec POLL_INTERVAL_SEC]\n [--request-timeout-sec REQUEST_TIMEOUT_SEC]\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n --spool-dir SPOOL_DIR\n --poll-interval-sec POLL_INTERVAL_SEC\n --request-timeout-sec REQUEST_TIMEOUT_SEC\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "spool_dir", "flags": [ "--spool-dir" ], "required": false, "default": ".arc-relay", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "poll_interval_sec", "flags": [ "--poll-interval-sec" ], "required": false, "default": 0.25, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "float" }, { "name": "request_timeout_sec", "flags": [ "--request-timeout-sec" ], "required": false, "default": 30.0, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "float" } ], "children": [], "summary": "Forward file-spooled relay requests to the local hub" }, { "command": "arc mcp", "description": null, "usage": "usage: arc mcp [-h] [--agent AGENT] [--base-url BASE_URL] [--no-ensure]\n [--storage STORAGE] [--ensure-timeout ENSURE_TIMEOUT]\n [--resume-key RESUME_KEY] [--progressive-tools] [--full-tools]", "help": "usage: arc mcp [-h] [--agent AGENT] [--base-url BASE_URL] [--no-ensure]\n [--storage STORAGE] [--ensure-timeout ENSURE_TIMEOUT]\n [--resume-key RESUME_KEY] [--progressive-tools] [--full-tools]\n\noptions:\n -h, --help show this help message and exit\n --agent AGENT Agent ID to register as\n --base-url BASE_URL\n --no-ensure Skip auto-ensure; assume the daemon is already\n running.\n --storage STORAGE Storage path used by auto-ensure. Defaults to /app.db.\n --ensure-timeout ENSURE_TIMEOUT\n Seconds auto-ensure waits for the daemon to come up.\n --resume-key RESUME_KEY\n Local adapter identity slot. After arc_join, a\n restarted MCP bridge resumes that exact joined\n identity instead of silently falling back to --agent.\n Intended for app-global adapters.\n --progressive-tools Progressive disclosure: advertise only the meta-tools\n (arc_search_tools / arc_describe_tool / arc_call_tool)\n plus a couple live-loop essentials, instead of the\n full tool list. Shrinks the MCP tool-definition\n context for small / local models; the full tool set\n stays reachable via arc_call_tool. Without either\n flag, the daemon's per-harness setting decides (GET\n /v1/tool-surface).\n --full-tools Force the full tool list, overriding the daemon's per-\n harness tool-surface setting.\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "agent", "flags": [ "--agent" ], "required": false, "default": "mcp-client", "help": "Agent ID to register as", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "no_ensure", "flags": [ "--no-ensure" ], "required": false, "default": false, "help": "Skip auto-ensure; assume the daemon is already running.", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "storage", "flags": [ "--storage" ], "required": false, "default": null, "help": "Storage path used by auto-ensure. Defaults to /app.db.", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "ensure_timeout", "flags": [ "--ensure-timeout" ], "required": false, "default": 30.0, "help": "Seconds auto-ensure waits for the daemon to come up.", "choices": null, "nargs": null, "metavar": null, "type": "float" }, { "name": "resume_key", "flags": [ "--resume-key" ], "required": false, "default": null, "help": "Local adapter identity slot. After arc_join, a restarted MCP bridge resumes that exact joined identity instead of silently falling back to --agent. Intended for app-global adapters.", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "progressive_tools", "flags": [ "--progressive-tools" ], "required": false, "default": false, "help": "Progressive disclosure: advertise only the meta-tools (arc_search_tools / arc_describe_tool / arc_call_tool) plus a couple live-loop essentials, instead of the full tool list. Shrinks the MCP tool-definition context for small / local models; the full tool set stays reachable via arc_call_tool. Without either flag, the daemon's per-harness setting decides (GET /v1/tool-surface).", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "full_tools", "flags": [ "--full-tools" ], "required": false, "default": false, "help": "Force the full tool list, overriding the daemon's per-harness tool-surface setting.", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Run Arc as an MCP server over stdio" }, { "command": "arc smoke-agent", "description": null, "usage": "usage: arc smoke-agent [-h] --role {smoke-a,smoke-b,smoke-c} --transport\n {http,relay} [--base-url BASE_URL]\n [--relay-dir RELAY_DIR] [--channel CHANNEL]\n [--thread-id THREAD_ID] [--claim-key CLAIM_KEY]\n [--timeout-sec TIMEOUT_SEC]\n [--poll-interval-sec POLL_INTERVAL_SEC]", "help": "usage: arc smoke-agent [-h] --role {smoke-a,smoke-b,smoke-c} --transport\n {http,relay} [--base-url BASE_URL]\n [--relay-dir RELAY_DIR] [--channel CHANNEL]\n [--thread-id THREAD_ID] [--claim-key CLAIM_KEY]\n [--timeout-sec TIMEOUT_SEC]\n [--poll-interval-sec POLL_INTERVAL_SEC]\n\noptions:\n -h, --help show this help message and exit\n --role {smoke-a,smoke-b,smoke-c}\n --transport {http,relay}\n --base-url BASE_URL\n --relay-dir RELAY_DIR\n --channel CHANNEL\n --thread-id THREAD_ID\n --claim-key CLAIM_KEY\n --timeout-sec TIMEOUT_SEC\n --poll-interval-sec POLL_INTERVAL_SEC\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "role", "flags": [ "--role" ], "required": true, "default": null, "help": null, "choices": [ "smoke-a", "smoke-b", "smoke-c" ], "nargs": null, "metavar": null, "type": null }, { "name": "transport", "flags": [ "--transport" ], "required": true, "default": null, "help": null, "choices": [ "http", "relay" ], "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "relay_dir", "flags": [ "--relay-dir" ], "required": false, "default": ".arc-relay", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "channel", "flags": [ "--channel" ], "required": false, "default": "smoke-room", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "thread_id", "flags": [ "--thread-id" ], "required": false, "default": "smoke-relay-001", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "claim_key", "flags": [ "--claim-key" ], "required": false, "default": "smoke-claim-001", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "timeout_sec", "flags": [ "--timeout-sec" ], "required": false, "default": 120.0, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "float" }, { "name": "poll_interval_sec", "flags": [ "--poll-interval-sec" ], "required": false, "default": 1.0, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "float" } ], "children": [], "summary": "Run a deterministic smoke-test role" }, { "command": "arc post", "description": null, "usage": "usage: arc post [-h] --agent AGENT [--base-url BASE_URL] [--channel CHANNEL]\n [--to TO]\n [--kind {artifact,chat,claim,handoff,notice,release,task,task_request,task_result}]\n [--thread-id THREAD_ID]\n body", "help": "usage: arc post [-h] --agent AGENT [--base-url BASE_URL] [--channel CHANNEL]\n [--to TO]\n [--kind {artifact,chat,claim,handoff,notice,release,task,task_request,task_result}]\n [--thread-id THREAD_ID]\n body\n\npositional arguments:\n body\n\noptions:\n -h, --help show this help message and exit\n --agent AGENT Your agent_id (registers with replace=True)\n --base-url BASE_URL\n --channel CHANNEL\n --to TO If set, sends as direct message to this agent\n --kind {artifact,chat,claim,handoff,notice,release,task,task_request,task_result}\n --thread-id THREAD_ID\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "agent", "flags": [ "--agent" ], "required": true, "default": null, "help": "Your agent_id (registers with replace=True)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "channel", "flags": [ "--channel" ], "required": false, "default": "general", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "to", "flags": [ "--to" ], "required": false, "default": null, "help": "If set, sends as direct message to this agent", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "kind", "flags": [ "--kind" ], "required": false, "default": "chat", "help": null, "choices": [ "artifact", "chat", "claim", "handoff", "notice", "release", "task", "task_request", "task_result" ], "nargs": null, "metavar": null, "type": null }, { "name": "thread_id", "flags": [ "--thread-id" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "body", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Post a message (or DM with --to)" }, { "command": "arc poll", "description": null, "usage": "usage: arc poll [-h] --agent AGENT [--base-url BASE_URL] [--channel CHANNEL]\n [--thread-id THREAD_ID] [--timeout TIMEOUT]\n [--since-id SINCE_ID] [--include-self]", "help": "usage: arc poll [-h] --agent AGENT [--base-url BASE_URL] [--channel CHANNEL]\n [--thread-id THREAD_ID] [--timeout TIMEOUT]\n [--since-id SINCE_ID] [--include-self]\n\noptions:\n -h, --help show this help message and exit\n --agent AGENT\n --base-url BASE_URL\n --channel CHANNEL\n --thread-id THREAD_ID\n --timeout TIMEOUT\n --since-id SINCE_ID\n --include-self Do not set exclude_self (default excludes own posts)\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "agent", "flags": [ "--agent" ], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "channel", "flags": [ "--channel" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "thread_id", "flags": [ "--thread-id" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "timeout", "flags": [ "--timeout" ], "required": false, "default": 30.0, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "float" }, { "name": "since_id", "flags": [ "--since-id" ], "required": false, "default": 0, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "include_self", "flags": [ "--include-self" ], "required": false, "default": false, "help": "Do not set exclude_self (default excludes own posts)", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Long-poll /v1/events as an agent (exclude_self by default)" }, { "command": "arc whoami", "description": null, "usage": "usage: arc whoami [-h] --agent AGENT [--base-url BASE_URL]", "help": "usage: arc whoami [-h] --agent AGENT [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --agent AGENT\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "agent", "flags": [ "--agent" ], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Print GET /v1/bootstrap for this agent" }, { "command": "arc resolve", "description": null, "usage": "usage: arc resolve [-h] [--base-url BASE_URL] [--json] [--timeout TIMEOUT]\n [path]", "help": "usage: arc resolve [-h] [--base-url BASE_URL] [--json] [--timeout TIMEOUT]\n [path]\n\npositional arguments:\n path directory to resolve (default: current directory)\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n --json print the full resolve payload as JSON\n --timeout TIMEOUT hub timeout in seconds (kept small: hook callers must\n never hang a session on a missing daemon)\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "path", "flags": [], "required": false, "default": null, "help": "directory to resolve (default: current directory)", "choices": null, "nargs": "?", "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": "print the full resolve payload as JSON", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "timeout", "flags": [ "--timeout" ], "required": false, "default": 2.0, "help": "hub timeout in seconds (kept small: hook callers must never hang a session on a missing daemon)", "choices": null, "nargs": null, "metavar": null, "type": "float" } ], "children": [], "summary": "Resolve the Arc room bound to a directory (hook/script-friendly)" }, { "command": "arc hook", "description": null, "usage": "usage: arc hook [-h] [--base-url BASE_URL] {session-start,stop}", "help": "usage: arc hook [-h] [--base-url BASE_URL] {session-start,stop}\n\npositional arguments:\n {session-start,stop} which harness hook event fired\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "event", "flags": [], "required": true, "default": null, "help": "which harness hook event fired", "choices": [ "session-start", "stop" ], "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Harness hook entrypoints (hook payload JSON on stdin)" }, { "command": "arc watch", "description": null, "usage": "usage: arc watch [-h] --agent AGENT [--base-url BASE_URL] [--room ROOM]\n [--path PATH] --until CONDITION [--timeout TIMEOUT]\n [--label LABEL] [--verbose]", "help": "usage: arc watch [-h] --agent AGENT [--base-url BASE_URL] [--room ROOM]\n [--path PATH] --until CONDITION [--timeout TIMEOUT]\n [--label LABEL] [--verbose]\n\noptions:\n -h, --help show this help message and exit\n --agent AGENT Your agent_id (receipts name it); the watch itself\n registers a sibling session .watch so your own\n session stays live\n --base-url BASE_URL\n --room ROOM room_id to watch (default: the room bound to\n --path/cwd, as `arc resolve` reports)\n --path PATH directory whose bound room to watch when --room is not\n given\n --until CONDITION condition to wait for; repeatable, ALL must hold at\n once: tasks-complete:, run-\n complete:, message-from:, seat-\n idle:\n --timeout TIMEOUT overall wait budget, e.g. 90s, 20m, 1h (default 20m; 0\n = evaluate once and exit)\n --label LABEL short label shown in room status while watching\n --verbose progress lines on stderr while waiting\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "agent", "flags": [ "--agent" ], "required": true, "default": null, "help": "Your agent_id (receipts name it); the watch itself registers a sibling session .watch so your own session stays live", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "room", "flags": [ "--room" ], "required": false, "default": null, "help": "room_id to watch (default: the room bound to --path/cwd, as `arc resolve` reports)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "path", "flags": [ "--path" ], "required": false, "default": null, "help": "directory whose bound room to watch when --room is not given", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "until", "flags": [ "--until" ], "required": true, "default": null, "help": "condition to wait for; repeatable, ALL must hold at once: tasks-complete:, run-complete:, message-from:, seat-idle:", "choices": null, "nargs": null, "metavar": "CONDITION", "type": null }, { "name": "timeout", "flags": [ "--timeout" ], "required": false, "default": "20m", "help": "overall wait budget, e.g. 90s, 20m, 1h (default 20m; 0 = evaluate once and exit)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "label", "flags": [ "--label" ], "required": false, "default": null, "help": "short label shown in room status while watching", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "verbose", "flags": [ "--verbose" ], "required": false, "default": false, "help": "progress lines on stderr while waiting", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Block until room conditions are met (the harness wake bridge \u2014 run as a background process; its exit re-invokes your harness turn)" }, { "command": "arc data-root", "description": null, "usage": "usage: arc data-root [-h]", "help": "usage: arc data-root [-h]\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Print the resolved Arc data root" }, { "command": "arc app", "description": null, "usage": "usage: arc app [-h] {start,status,stop} ...", "help": "usage: arc app [-h] {start,status,stop} ...\n\npositional arguments:\n {start,status,stop}\n start Start hub against /app.db\n status GET /v1/app/status against the running hub\n stop Stop a running hub (alias for `arc stop`)\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc app start", "description": null, "usage": "usage: arc app start [-h] [--host HOST] [--port PORT] [--allow-remote]\n [--quiet] [--spool-dir SPOOL_DIR]\n [--auto-ensure-adapters]", "help": "usage: arc app start [-h] [--host HOST] [--port PORT] [--allow-remote]\n [--quiet] [--spool-dir SPOOL_DIR]\n [--auto-ensure-adapters]\n\noptions:\n -h, --help show this help message and exit\n --host HOST\n --port PORT\n --allow-remote\n --quiet\n --spool-dir SPOOL_DIR\n --auto-ensure-adapters\n Install/repair detected harness adapters during\n startup.\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "host", "flags": [ "--host" ], "required": false, "default": "127.0.0.1", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "port", "flags": [ "--port" ], "required": false, "default": 6969, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "allow_remote", "flags": [ "--allow-remote" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "quiet", "flags": [ "--quiet" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "spool_dir", "flags": [ "--spool-dir" ], "required": false, "default": ".arc-relay", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "auto_ensure_adapters", "flags": [ "--auto-ensure-adapters" ], "required": false, "default": false, "help": "Install/repair detected harness adapters during startup.", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Start hub against /app.db" }, { "command": "arc app status", "description": null, "usage": "usage: arc app status [-h] [--base-url BASE_URL]", "help": "usage: arc app status [-h] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "GET /v1/app/status against the running hub" }, { "command": "arc app stop", "description": null, "usage": "usage: arc app stop [-h] [--host HOST] [--port PORT] [--storage STORAGE]", "help": "usage: arc app stop [-h] [--host HOST] [--port PORT] [--storage STORAGE]\n\noptions:\n -h, --help show this help message and exit\n --host HOST\n --port PORT\n --storage STORAGE SQLite path. Defaults to /app.db.\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "host", "flags": [ "--host" ], "required": false, "default": "127.0.0.1", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "port", "flags": [ "--port" ], "required": false, "default": 6969, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "storage", "flags": [ "--storage" ], "required": false, "default": null, "help": "SQLite path. Defaults to /app.db.", "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Stop a running hub (alias for `arc stop`)" } ], "summary": "Manage the Arc application daemon" }, { "command": "arc project", "description": null, "usage": "usage: arc project [-h] {create,list,export} ...", "help": "usage: arc project [-h] {create,list,export} ...\n\npositional arguments:\n {create,list,export}\n create Create a project\n list List projects\n export Export a project bundle\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc project create", "description": null, "usage": "usage: arc project create [-h] --name NAME [--glyph GLYPH]\n [--base-url BASE_URL]", "help": "usage: arc project create [-h] --name NAME [--glyph GLYPH]\n [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --name NAME\n --glyph GLYPH\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "name", "flags": [ "--name" ], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "glyph", "flags": [ "--glyph" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Create a project" }, { "command": "arc project list", "description": null, "usage": "usage: arc project list [-h] [--base-url BASE_URL]", "help": "usage: arc project list [-h] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List projects" }, { "command": "arc project export", "description": null, "usage": "usage: arc project export [-h] [--out OUT_DIR] [--base-url BASE_URL] project", "help": "usage: arc project export [-h] [--out OUT_DIR] [--base-url BASE_URL] project\n\npositional arguments:\n project project_id or slug\n\noptions:\n -h, --help show this help message and exit\n --out OUT_DIR\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "project", "flags": [], "required": true, "default": null, "help": "project_id or slug", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "out_dir", "flags": [ "--out" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Export a project bundle" } ], "summary": "Manage Arc projects" }, { "command": "arc capsule", "description": null, "usage": "usage: arc capsule [-h] {export,inspect,import} ...", "help": "usage: arc capsule [-h] {export,inspect,import} ...\n\npositional arguments:\n {export,inspect,import}\n export Save a share-safe portable .arcpack capsule\n inspect validate and summarize a capsule without importing\n import transactionally import a capsule as a new project\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc capsule export", "description": null, "usage": "usage: arc capsule export [-h] --out OUT\n [--scope {knowledge,complete,selected_rooms}]\n [--rooms ROOMS]\n [--privacy {share_safe,full_history}] [--git-mirror]\n [--yes] [--base-url BASE_URL]\n project", "help": "usage: arc capsule export [-h] --out OUT\n [--scope {knowledge,complete,selected_rooms}]\n [--rooms ROOMS]\n [--privacy {share_safe,full_history}] [--git-mirror]\n [--yes] [--base-url BASE_URL]\n project\n\npositional arguments:\n project project_id or slug\n\noptions:\n -h, --help show this help message and exit\n --out OUT destination .arcpack path (never overwritten)\n --scope {knowledge,complete,selected_rooms}\n --rooms ROOMS comma-separated room ids for --scope selected_rooms\n --privacy {share_safe,full_history}\n --git-mirror also write a readable .arc mirror when one bound Git\n workspace already exists; never installs, stages,\n commits, or pushes Git\n --yes, -y accept the daemon's exact export confirmation prompt\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "project", "flags": [], "required": true, "default": null, "help": "project_id or slug", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "out", "flags": [ "--out" ], "required": true, "default": null, "help": "destination .arcpack path (never overwritten)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "scope", "flags": [ "--scope" ], "required": false, "default": "knowledge", "help": null, "choices": [ "knowledge", "complete", "selected_rooms" ], "nargs": null, "metavar": null, "type": null }, { "name": "rooms", "flags": [ "--rooms" ], "required": false, "default": null, "help": "comma-separated room ids for --scope selected_rooms", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "privacy", "flags": [ "--privacy" ], "required": false, "default": "share_safe", "help": null, "choices": [ "share_safe", "full_history" ], "nargs": null, "metavar": null, "type": null }, { "name": "git_mirror", "flags": [ "--git-mirror" ], "required": false, "default": false, "help": "also write a readable .arc mirror when one bound Git workspace already exists; never installs, stages, commits, or pushes Git", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "yes", "flags": [ "--yes", "-y" ], "required": false, "default": false, "help": "accept the daemon's exact export confirmation prompt", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Save a share-safe portable .arcpack capsule" }, { "command": "arc capsule inspect", "description": null, "usage": "usage: arc capsule inspect [-h] [--base-url BASE_URL] path", "help": "usage: arc capsule inspect [-h] [--base-url BASE_URL] path\n\npositional arguments:\n path\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "path", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "validate and summarize a capsule without importing" }, { "command": "arc capsule import", "description": null, "usage": "usage: arc capsule import [-h] [--yes] [--base-url BASE_URL] path", "help": "usage: arc capsule import [-h] [--yes] [--base-url BASE_URL] path\n\npositional arguments:\n path\n\noptions:\n -h, --help show this help message and exit\n --yes, -y accept the daemon's exact import confirmation prompt\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "path", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "yes", "flags": [ "--yes", "-y" ], "required": false, "default": false, "help": "accept the daemon's exact import confirmation prompt", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "transactionally import a capsule as a new project" } ], "summary": "Move an Arc project without Git or workspace file contents" }, { "command": "arc room", "description": null, "usage": "usage: arc room [-h] {create,list} ...", "help": "usage: arc room [-h] {create,list} ...\n\npositional arguments:\n {create,list}\n create Create a room\n list List rooms\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc room create", "description": null, "usage": "usage: arc room create [-h] --project PROJECT --name NAME [--topic TOPIC]\n [--force] [--force-reason FORCE_REASON]\n [--base-url BASE_URL]", "help": "usage: arc room create [-h] --project PROJECT --name NAME [--topic TOPIC]\n [--force] [--force-reason FORCE_REASON]\n [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --project PROJECT project_id or slug\n --name NAME\n --topic TOPIC\n --force create even though a look-alike room exists in the\n project (409 similar_room_exists)\n --force-reason FORCE_REASON\n why the sibling room is needed (recorded)\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "project", "flags": [ "--project" ], "required": true, "default": null, "help": "project_id or slug", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "name", "flags": [ "--name" ], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "topic", "flags": [ "--topic" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "force", "flags": [ "--force" ], "required": false, "default": false, "help": "create even though a look-alike room exists in the project (409 similar_room_exists)", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "force_reason", "flags": [ "--force-reason" ], "required": false, "default": null, "help": "why the sibling room is needed (recorded)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Create a room" }, { "command": "arc room list", "description": null, "usage": "usage: arc room list [-h] --project PROJECT [--base-url BASE_URL]", "help": "usage: arc room list [-h] --project PROJECT [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --project PROJECT project_id or slug\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "project", "flags": [ "--project" ], "required": true, "default": null, "help": "project_id or slug", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List rooms" } ], "summary": "Manage Arc rooms" }, { "command": "arc decision", "description": null, "usage": "usage: arc decision [-h] {add} ...", "help": "usage: arc decision [-h] {add} ...\n\npositional arguments:\n {add}\n add Add a decision\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc decision add", "description": null, "usage": "usage: arc decision add [-h] --room ROOM_ID --title TITLE [--note NOTE]\n [--by BY_AGENT_ID] [--metadata-json METADATA_JSON]\n [--base-url BASE_URL]", "help": "usage: arc decision add [-h] --room ROOM_ID --title TITLE [--note NOTE]\n [--by BY_AGENT_ID] [--metadata-json METADATA_JSON]\n [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --room ROOM_ID\n --title TITLE\n --note NOTE\n --by BY_AGENT_ID\n --metadata-json METADATA_JSON\n Optional JSON object for the decision's metadata (e.g.\n '{\"handoff_accepted\": true}'). Must be a valid JSON\n object; max nesting depth 4.\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "room_id", "flags": [ "--room" ], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "title", "flags": [ "--title" ], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "note", "flags": [ "--note" ], "required": false, "default": "", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "by_agent_id", "flags": [ "--by" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "metadata_json", "flags": [ "--metadata-json" ], "required": false, "default": null, "help": "Optional JSON object for the decision's metadata (e.g. '{\"handoff_accepted\": true}'). Must be a valid JSON object; max nesting depth 4.", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Add a decision" } ], "summary": "Manage Arc decisions" }, { "command": "arc providers", "description": null, "usage": "usage: arc providers [-h] [--json] [--base-url BASE_URL]", "help": "usage: arc providers [-h] [--json] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --json\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List hosted provider presets (id, env var, endpoint)" }, { "command": "arc connection", "description": null, "usage": "usage: arc connection [-h] {list,create,verify,models} ...", "help": "usage: arc connection [-h] {list,create,verify,models} ...\n\npositional arguments:\n {list,create,verify,models}\n list List provider connections\n create Create a connection; the key comes from the OS store\n or the provider's env var (see `arc providers`)\n verify Live-verify a connection (fetches the provider\n catalog)\n models List a connection's cached provider models\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc connection list", "description": null, "usage": "usage: arc connection list [-h] [--json] [--base-url BASE_URL]", "help": "usage: arc connection list [-h] [--json] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --json\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List provider connections" }, { "command": "arc connection create", "description": null, "usage": "usage: arc connection create [-h] --provider PROVIDER [--label LABEL]\n [--region REGION] [--endpoint ENDPOINT]\n [--env-credential] [--json] [--base-url BASE_URL]", "help": "usage: arc connection create [-h] --provider PROVIDER [--label LABEL]\n [--region REGION] [--endpoint ENDPOINT]\n [--env-credential] [--json] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --provider PROVIDER preset id, e.g. openrouter, anthropic, groq\n --label LABEL\n --region REGION\n --endpoint ENDPOINT base URL (custom provider only)\n --env-credential require the daemon to resolve the key from the\n provider's env var; exit 2 if it cannot\n --json\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "provider", "flags": [ "--provider" ], "required": true, "default": null, "help": "preset id, e.g. openrouter, anthropic, groq", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "label", "flags": [ "--label" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "region", "flags": [ "--region" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "endpoint", "flags": [ "--endpoint" ], "required": false, "default": null, "help": "base URL (custom provider only)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "env_credential", "flags": [ "--env-credential" ], "required": false, "default": false, "help": "require the daemon to resolve the key from the provider's env var; exit 2 if it cannot", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Create a connection; the key comes from the OS store or the provider's env var (see `arc providers`)" }, { "command": "arc connection verify", "description": null, "usage": "usage: arc connection verify [-h] [--json] [--base-url BASE_URL] connection", "help": "usage: arc connection verify [-h] [--json] [--base-url BASE_URL] connection\n\npositional arguments:\n connection connection id, label, or id prefix\n\noptions:\n -h, --help show this help message and exit\n --json\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "connection", "flags": [], "required": true, "default": null, "help": "connection id, label, or id prefix", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Live-verify a connection (fetches the provider catalog)" }, { "command": "arc connection models", "description": null, "usage": "usage: arc connection models [-h] [--json] [--base-url BASE_URL] connection", "help": "usage: arc connection models [-h] [--json] [--base-url BASE_URL] connection\n\npositional arguments:\n connection connection id, label, or id prefix\n\noptions:\n -h, --help show this help message and exit\n --json\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "connection", "flags": [], "required": true, "default": null, "help": "connection id, label, or id prefix", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List a connection's cached provider models" } ], "summary": "Manage hosted provider connections without the desktop" }, { "command": "arc connections", "description": null, "usage": "usage: arc connection [-h] {list,create,verify,models} ...", "help": "usage: arc connection [-h] {list,create,verify,models} ...\n\npositional arguments:\n {list,create,verify,models}\n list List provider connections\n create Create a connection; the key comes from the OS store\n or the provider's env var (see `arc providers`)\n verify Live-verify a connection (fetches the provider\n catalog)\n models List a connection's cached provider models\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc connections list", "description": null, "usage": "usage: arc connection list [-h] [--json] [--base-url BASE_URL]", "help": "usage: arc connection list [-h] [--json] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --json\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List provider connections" }, { "command": "arc connections create", "description": null, "usage": "usage: arc connection create [-h] --provider PROVIDER [--label LABEL]\n [--region REGION] [--endpoint ENDPOINT]\n [--env-credential] [--json] [--base-url BASE_URL]", "help": "usage: arc connection create [-h] --provider PROVIDER [--label LABEL]\n [--region REGION] [--endpoint ENDPOINT]\n [--env-credential] [--json] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --provider PROVIDER preset id, e.g. openrouter, anthropic, groq\n --label LABEL\n --region REGION\n --endpoint ENDPOINT base URL (custom provider only)\n --env-credential require the daemon to resolve the key from the\n provider's env var; exit 2 if it cannot\n --json\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "provider", "flags": [ "--provider" ], "required": true, "default": null, "help": "preset id, e.g. openrouter, anthropic, groq", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "label", "flags": [ "--label" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "region", "flags": [ "--region" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "endpoint", "flags": [ "--endpoint" ], "required": false, "default": null, "help": "base URL (custom provider only)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "env_credential", "flags": [ "--env-credential" ], "required": false, "default": false, "help": "require the daemon to resolve the key from the provider's env var; exit 2 if it cannot", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Create a connection; the key comes from the OS store or the provider's env var (see `arc providers`)" }, { "command": "arc connections verify", "description": null, "usage": "usage: arc connection verify [-h] [--json] [--base-url BASE_URL] connection", "help": "usage: arc connection verify [-h] [--json] [--base-url BASE_URL] connection\n\npositional arguments:\n connection connection id, label, or id prefix\n\noptions:\n -h, --help show this help message and exit\n --json\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "connection", "flags": [], "required": true, "default": null, "help": "connection id, label, or id prefix", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Live-verify a connection (fetches the provider catalog)" }, { "command": "arc connections models", "description": null, "usage": "usage: arc connection models [-h] [--json] [--base-url BASE_URL] connection", "help": "usage: arc connection models [-h] [--json] [--base-url BASE_URL] connection\n\npositional arguments:\n connection connection id, label, or id prefix\n\noptions:\n -h, --help show this help message and exit\n --json\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "connection", "flags": [], "required": true, "default": null, "help": "connection id, label, or id prefix", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "json", "flags": [ "--json" ], "required": false, "default": false, "help": null, "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List a connection's cached provider models" } ], "summary": null }, { "command": "arc invite", "description": null, "usage": "usage: arc invite [-h] {create,preview,revoke,list} ...", "help": "usage: arc invite [-h] {create,preview,revoke,list} ...\n\npositional arguments:\n {create,preview,revoke,list}\n create Create a join invite for a room\n preview Preview an invite without consuming it\n revoke Revoke an invite by code\n list List invites\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc invite create", "description": null, "usage": "usage: arc invite create [-h] --project PROJECT --room ROOM [--role ROLE]\n [--handle HANDLE] [--harness HARNESS]\n [--ttl-sec TTL_SEC] [--max-uses MAX_USES]\n [--base-url BASE_URL]", "help": "usage: arc invite create [-h] --project PROJECT --room ROOM [--role ROLE]\n [--handle HANDLE] [--harness HARNESS]\n [--ttl-sec TTL_SEC] [--max-uses MAX_USES]\n [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --project PROJECT project_id, slug, or name\n --room ROOM room_id, slug, or name\n --role ROLE optional role hint (ancestor, descendant, implementer,\n ...)\n --handle HANDLE suggested agent_handle for the joining agent\n --harness HARNESS preferred_harness hint (claude-code, codex-desktop,\n codex, cursor, generic)\n --ttl-sec TTL_SEC\n --max-uses MAX_USES\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "project", "flags": [ "--project" ], "required": true, "default": null, "help": "project_id, slug, or name", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "room", "flags": [ "--room" ], "required": true, "default": null, "help": "room_id, slug, or name", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "role", "flags": [ "--role" ], "required": false, "default": null, "help": "optional role hint (ancestor, descendant, implementer, ...)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "handle", "flags": [ "--handle" ], "required": false, "default": null, "help": "suggested agent_handle for the joining agent", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "harness", "flags": [ "--harness" ], "required": false, "default": null, "help": "preferred_harness hint (claude-code, codex-desktop, codex, cursor, generic)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "ttl_sec", "flags": [ "--ttl-sec" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "max_uses", "flags": [ "--max-uses" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": "int" }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Create a join invite for a room" }, { "command": "arc invite preview", "description": null, "usage": "usage: arc invite preview [-h] [--base-url BASE_URL] code", "help": "usage: arc invite preview [-h] [--base-url BASE_URL] code\n\npositional arguments:\n code\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "code", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Preview an invite without consuming it" }, { "command": "arc invite revoke", "description": null, "usage": "usage: arc invite revoke [-h] [--base-url BASE_URL] code", "help": "usage: arc invite revoke [-h] [--base-url BASE_URL] code\n\npositional arguments:\n code\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "code", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Revoke an invite by code" }, { "command": "arc invite list", "description": null, "usage": "usage: arc invite list [-h] [--room ROOM] [--base-url BASE_URL]", "help": "usage: arc invite list [-h] [--room ROOM] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --room ROOM room_id to filter on\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "room", "flags": [ "--room" ], "required": false, "default": null, "help": "room_id to filter on", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List invites" } ], "summary": "Manage room invites" }, { "command": "arc join", "description": null, "usage": "usage: arc join [-h] [--as HANDLE] [--display-name DISPLAY_NAME]\n [--harness HARNESS] [--capabilities CAPABILITIES]\n [--base-url BASE_URL]\n code", "help": "usage: arc join [-h] [--as HANDLE] [--display-name DISPLAY_NAME]\n [--harness HARNESS] [--capabilities CAPABILITIES]\n [--base-url BASE_URL]\n code\n\npositional arguments:\n code short invite code (e.g. A5G8)\n\noptions:\n -h, --help show this help message and exit\n --as HANDLE agent_id/handle to register as\n --display-name DISPLAY_NAME\n --harness HARNESS preferred_harness hint\n --capabilities CAPABILITIES\n comma-separated capability strings\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "code", "flags": [], "required": true, "default": null, "help": "short invite code (e.g. A5G8)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "handle", "flags": [ "--as" ], "required": false, "default": null, "help": "agent_id/handle to register as", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "display_name", "flags": [ "--display-name" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "harness", "flags": [ "--harness" ], "required": false, "default": null, "help": "preferred_harness hint", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "capabilities", "flags": [ "--capabilities" ], "required": false, "default": null, "help": "comma-separated capability strings", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Accept a join invite as an agent" }, { "command": "arc adapter", "description": null, "usage": "usage: arc adapter [-h]\n {list,status,preview,preview-uninstall,install,uninstall,verify,repair}\n ...", "help": "usage: arc adapter [-h]\n {list,status,preview,preview-uninstall,install,uninstall,verify,repair}\n ...\n\npositional arguments:\n {list,status,preview,preview-uninstall,install,uninstall,verify,repair}\n list List registered adapters and current status\n status Show detail for one adapter\n preview Preview install changes for an adapter\n preview-uninstall Preview uninstall changes for an adapter\n install Install an adapter\n uninstall Uninstall an adapter\n verify Verify an adapter is functioning\n repair Re-apply an adapter install on top of an existing\n region\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc adapter list", "description": null, "usage": "usage: arc adapter list [-h] [--base-url BASE_URL]", "help": "usage: arc adapter list [-h] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List registered adapters and current status" }, { "command": "arc adapter status", "description": null, "usage": "usage: arc adapter status [-h] [--base-url BASE_URL] harness", "help": "usage: arc adapter status [-h] [--base-url BASE_URL] harness\n\npositional arguments:\n harness harness_id (e.g. generic, claude-code)\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "harness", "flags": [], "required": true, "default": null, "help": "harness_id (e.g. generic, claude-code)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Show detail for one adapter" }, { "command": "arc adapter preview", "description": null, "usage": "usage: arc adapter preview [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL]\n harness", "help": "usage: arc adapter preview [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL]\n harness\n\npositional arguments:\n harness\n\noptions:\n -h, --help show this help message and exit\n --scope SCOPE adapter-specific scope (e.g. global, project)\n --path PATH project root for --scope project (Cursor)\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "harness", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "scope", "flags": [ "--scope" ], "required": false, "default": null, "help": "adapter-specific scope (e.g. global, project)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "path", "flags": [ "--path" ], "required": false, "default": null, "help": "project root for --scope project (Cursor)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Preview install changes for an adapter" }, { "command": "arc adapter preview-uninstall", "description": null, "usage": "usage: arc adapter preview-uninstall [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL]\n harness", "help": "usage: arc adapter preview-uninstall [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL]\n harness\n\npositional arguments:\n harness\n\noptions:\n -h, --help show this help message and exit\n --scope SCOPE\n --path PATH project root for --scope project (Cursor)\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "harness", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "scope", "flags": [ "--scope" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "path", "flags": [ "--path" ], "required": false, "default": null, "help": "project root for --scope project (Cursor)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Preview uninstall changes for an adapter" }, { "command": "arc adapter install", "description": null, "usage": "usage: arc adapter install [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL] [--yes]\n harness", "help": "usage: arc adapter install [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL] [--yes]\n harness\n\npositional arguments:\n harness\n\noptions:\n -h, --help show this help message and exit\n --scope SCOPE adapter-specific scope\n --path PATH project root for --scope project (Cursor)\n --base-url BASE_URL\n --yes, -y auto-confirm the sensitive-action prompt (unattended)\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "harness", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "scope", "flags": [ "--scope" ], "required": false, "default": null, "help": "adapter-specific scope", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "path", "flags": [ "--path" ], "required": false, "default": null, "help": "project root for --scope project (Cursor)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "yes", "flags": [ "--yes", "-y" ], "required": false, "default": false, "help": "auto-confirm the sensitive-action prompt (unattended)", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Install an adapter" }, { "command": "arc adapter uninstall", "description": null, "usage": "usage: arc adapter uninstall [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL] [--yes]\n harness", "help": "usage: arc adapter uninstall [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL] [--yes]\n harness\n\npositional arguments:\n harness\n\noptions:\n -h, --help show this help message and exit\n --scope SCOPE\n --path PATH project root for --scope project (Cursor)\n --base-url BASE_URL\n --yes, -y auto-confirm the sensitive-action prompt (unattended)\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "harness", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "scope", "flags": [ "--scope" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "path", "flags": [ "--path" ], "required": false, "default": null, "help": "project root for --scope project (Cursor)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "yes", "flags": [ "--yes", "-y" ], "required": false, "default": false, "help": "auto-confirm the sensitive-action prompt (unattended)", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Uninstall an adapter" }, { "command": "arc adapter verify", "description": null, "usage": "usage: arc adapter verify [-h] [--base-url BASE_URL] harness", "help": "usage: arc adapter verify [-h] [--base-url BASE_URL] harness\n\npositional arguments:\n harness\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "harness", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Verify an adapter is functioning" }, { "command": "arc adapter repair", "description": null, "usage": "usage: arc adapter repair [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL]\n harness", "help": "usage: arc adapter repair [-h] [--scope SCOPE] [--path PATH]\n [--base-url BASE_URL]\n harness\n\npositional arguments:\n harness\n\noptions:\n -h, --help show this help message and exit\n --scope SCOPE\n --path PATH project root for --scope project (Cursor)\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "harness", "flags": [], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "scope", "flags": [ "--scope" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "path", "flags": [ "--path" ], "required": false, "default": null, "help": "project root for --scope project (Cursor)", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Re-apply an adapter install on top of an existing region" } ], "summary": "Configure harness connections" }, { "command": "arc artifact", "description": null, "usage": "usage: arc artifact [-h] {add} ...", "help": "usage: arc artifact [-h] {add} ...\n\npositional arguments:\n {add}\n add Add an artifact\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc artifact add", "description": null, "usage": "usage: arc artifact add [-h] --room ROOM_ID --title TITLE --kind KIND\n [--by BY_AGENT_ID] [--body BODY | --file FILE]\n [--base-url BASE_URL]", "help": "usage: arc artifact add [-h] --room ROOM_ID --title TITLE --kind KIND\n [--by BY_AGENT_ID] [--body BODY | --file FILE]\n [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --room ROOM_ID\n --title TITLE\n --kind KIND\n --by BY_AGENT_ID\n --body BODY\n --file FILE\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "room_id", "flags": [ "--room" ], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "title", "flags": [ "--title" ], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "kind", "flags": [ "--kind" ], "required": true, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "by_agent_id", "flags": [ "--by" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "body", "flags": [ "--body" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "file", "flags": [ "--file" ], "required": false, "default": null, "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Add an artifact" } ], "summary": "Manage Arc artifacts" }, { "command": "arc browser", "description": null, "usage": "usage: arc browser [-h] {install,engines} ...", "help": "usage: arc browser [-h] {install,engines} ...\n\npositional arguments:\n {install,engines}\n install Download + sha256-verify the pinned Chrome-for-Testing\n build\n engines List discovered browser engines in preference order\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc browser install", "description": null, "usage": "usage: arc browser install [-h] [--data-root DATA_ROOT]", "help": "usage: arc browser install [-h] [--data-root DATA_ROOT]\n\noptions:\n -h, --help show this help message and exit\n --data-root DATA_ROOT\n override the Arc data root (default: arc data-root)\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "data_root", "flags": [ "--data-root" ], "required": false, "default": null, "help": "override the Arc data root (default: arc data-root)", "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Download + sha256-verify the pinned Chrome-for-Testing build" }, { "command": "arc browser engines", "description": null, "usage": "usage: arc browser engines [-h] [--data-root DATA_ROOT]", "help": "usage: arc browser engines [-h] [--data-root DATA_ROOT]\n\noptions:\n -h, --help show this help message and exit\n --data-root DATA_ROOT\n override the Arc data root (default: arc data-root)\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "data_root", "flags": [ "--data-root" ], "required": false, "default": null, "help": "override the Arc data root (default: arc data-root)", "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "List discovered browser engines in preference order" } ], "summary": "Manage the room-browser engine" }, { "command": "arc license", "description": null, "usage": "usage: arc license [-h] {show,verify,activate,deactivate} ...", "help": "usage: arc license [-h] {show,verify,activate,deactivate} ...\n\npositional arguments:\n {show,verify,activate,deactivate}\n show Print the current license state (offline check)\n verify Ask the license server whether the key is still valid\n (informational \u2014 never changes anything)\n activate Activate this machine with a license key\n deactivate Free this machine's activation slot\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [ { "command": "arc license show", "description": null, "usage": "usage: arc license show [-h]", "help": "usage: arc license show [-h]\n\noptions:\n -h, --help show this help message and exit\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Print the current license state (offline check)" }, { "command": "arc license verify", "description": null, "usage": "usage: arc license verify [-h] [--base-url BASE_URL]", "help": "usage: arc license verify [-h] [--base-url BASE_URL]\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null } ], "children": [], "summary": "Ask the license server whether the key is still valid (informational \u2014 never changes anything)" }, { "command": "arc license activate", "description": null, "usage": "usage: arc license activate [-h] [--base-url BASE_URL] [--yes] key", "help": "usage: arc license activate [-h] [--base-url BASE_URL] [--yes] key\n\npositional arguments:\n key the license key from your purchase email\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n --yes, -y skip the confirmation prompt\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "key", "flags": [], "required": true, "default": null, "help": "the license key from your purchase email", "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "yes", "flags": [ "--yes", "-y" ], "required": false, "default": false, "help": "skip the confirmation prompt", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Activate this machine with a license key" }, { "command": "arc license deactivate", "description": null, "usage": "usage: arc license deactivate [-h] [--base-url BASE_URL] [--yes]", "help": "usage: arc license deactivate [-h] [--base-url BASE_URL] [--yes]\n\noptions:\n -h, --help show this help message and exit\n --base-url BASE_URL\n --yes, -y skip the confirmation prompt\n", "arguments": [ { "name": "help", "flags": [ "-h", "--help" ], "required": false, "help": "show this help message and exit", "choices": null, "nargs": 0, "metavar": null, "type": null }, { "name": "base_url", "flags": [ "--base-url" ], "required": false, "default": "http://127.0.0.1:6969", "help": null, "choices": null, "nargs": null, "metavar": null, "type": null }, { "name": "yes", "flags": [ "--yes", "-y" ], "required": false, "default": false, "help": "skip the confirmation prompt", "choices": null, "nargs": 0, "metavar": null, "type": null } ], "children": [], "summary": "Free this machine's activation slot" } ], "summary": "Manage the Arc license" } ] }