argsbarg 7.0.11 → 7.1.1

package/examples/mcp-plugin/docs/cli.md

@@ -0,0 +1,2026 @@
+<!-- Generated by full-example-json docs cli --save; do not edit. -->
+
+# full-example-json — CLI API reference
+
+Argsbarg schema-first copy template (@sg schemagen, JSON schemas, REST CRUD)
+
+Machine-readable export: `full-example-json docs cli-schema`
+
+## `full-example-json`
+
+Argsbarg schema-first copy template (@sg schemagen, JSON schemas, REST CRUD)
+
+#### Subcommands
+
+- `echo` — Echo a message (MCP-friendly leaf).
+- `render-json` — Echo a JSON message (schema-first JSON leaf demo).
+- `status` — Show app version.
+- `workspaces` — Workspace collection and CRUD.
+
+### `full-example-json echo`
+
+Echo a message (MCP-friendly leaf).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--message` | string | required | — | Text to print. |
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+#### `full-example-json echo version`
+
+Print the program version.
+
+#### `full-example-json echo configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+##### `full-example-json echo configure install`
+
+Install agent artifacts and bootstrap app config.
+
+##### `full-example-json echo configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+##### `full-example-json echo configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+#### `full-example-json echo docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+##### `full-example-json echo docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json echo docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json echo docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json echo docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json echo docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json echo docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### `full-example-json echo mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+##### `full-example-json echo mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+#### `full-example-json echo http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+### `full-example-json render-json`
+
+Echo a JSON message (schema-first JSON leaf demo).
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+#### `full-example-json render-json version`
+
+Print the program version.
+
+#### `full-example-json render-json configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+##### `full-example-json render-json configure install`
+
+Install agent artifacts and bootstrap app config.
+
+##### `full-example-json render-json configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+##### `full-example-json render-json configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+#### `full-example-json render-json docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+##### `full-example-json render-json docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json render-json docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json render-json docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json render-json docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json render-json docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json render-json docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### `full-example-json render-json mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+##### `full-example-json render-json mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+#### `full-example-json render-json http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+### `full-example-json status`
+
+Show app version.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Emit JSON. |
+
+#### Output
+
+JSON Schema for output when/if handler emits JSON
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "App version from program root."
+    }
+  },
+  "required": [
+    "version"
+  ],
+  "additionalProperties": false,
+  "definitions": {}
+}
+```
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+#### `full-example-json status version`
+
+Print the program version.
+
+#### `full-example-json status configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+##### `full-example-json status configure install`
+
+Install agent artifacts and bootstrap app config.
+
+##### `full-example-json status configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+##### `full-example-json status configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+#### `full-example-json status docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+##### `full-example-json status docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json status docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json status docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json status docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json status docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json status docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### `full-example-json status mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+##### `full-example-json status mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+#### `full-example-json status http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+### `full-example-json workspaces`
+
+Workspace collection and CRUD.
+
+#### Subcommands
+
+- `get` — List workspaces.
+- `post` — Create a workspace.
+- `:id` — One workspace by id.
+
+#### `full-example-json workspaces get`
+
+List workspaces.
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+##### `full-example-json workspaces get version`
+
+Print the program version.
+
+##### `full-example-json workspaces get configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+###### `full-example-json workspaces get configure install`
+
+Install agent artifacts and bootstrap app config.
+
+###### `full-example-json workspaces get configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+###### `full-example-json workspaces get configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+##### `full-example-json workspaces get docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+###### `full-example-json workspaces get docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces get docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces get docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces get docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces get docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces get docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json workspaces get mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces get mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+##### `full-example-json workspaces get http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### `full-example-json workspaces post`
+
+Create a workspace.
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+##### `full-example-json workspaces post version`
+
+Print the program version.
+
+##### `full-example-json workspaces post configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+###### `full-example-json workspaces post configure install`
+
+Install agent artifacts and bootstrap app config.
+
+###### `full-example-json workspaces post configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+###### `full-example-json workspaces post configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+##### `full-example-json workspaces post docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+###### `full-example-json workspaces post docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces post docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces post docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces post docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces post docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces post docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+##### `full-example-json workspaces post mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces post mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+##### `full-example-json workspaces post http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### `full-example-json workspaces :id`
+
+One workspace by id.
+
+#### Subcommands
+
+- `get` — Get one workspace.
+- `put` — Replace a workspace.
+- `patch` — Patch a workspace name.
+- `delete` — Delete a workspace.
+
+##### `full-example-json workspaces :id get`
+
+Get one workspace.
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+###### `full-example-json workspaces :id get version`
+
+Print the program version.
+
+###### `full-example-json workspaces :id get configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+###### `full-example-json workspaces :id get configure install`
+
+Install agent artifacts and bootstrap app config.
+
+###### `full-example-json workspaces :id get configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+###### `full-example-json workspaces :id get configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+###### `full-example-json workspaces :id get docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+###### `full-example-json workspaces :id get docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id get docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id get docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id get docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id get docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id get docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id get mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces :id get mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces :id get http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+##### `full-example-json workspaces :id put`
+
+Replace a workspace.
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+###### `full-example-json workspaces :id put version`
+
+Print the program version.
+
+###### `full-example-json workspaces :id put configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+###### `full-example-json workspaces :id put configure install`
+
+Install agent artifacts and bootstrap app config.
+
+###### `full-example-json workspaces :id put configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+###### `full-example-json workspaces :id put configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+###### `full-example-json workspaces :id put docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+###### `full-example-json workspaces :id put docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id put docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id put docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id put docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id put docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id put docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id put mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces :id put mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces :id put http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+##### `full-example-json workspaces :id patch`
+
+Patch a workspace name.
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+###### `full-example-json workspaces :id patch version`
+
+Print the program version.
+
+###### `full-example-json workspaces :id patch configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+###### `full-example-json workspaces :id patch configure install`
+
+Install agent artifacts and bootstrap app config.
+
+###### `full-example-json workspaces :id patch configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+###### `full-example-json workspaces :id patch configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+###### `full-example-json workspaces :id patch docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+###### `full-example-json workspaces :id patch docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id patch docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id patch docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id patch docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id patch docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id patch docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id patch mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces :id patch mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces :id patch http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+##### `full-example-json workspaces :id delete`
+
+Delete a workspace.
+
+#### Subcommands
+
+- `version` — Print the program version.
+- `configure` — Set up MCP config for this app (binary via Homebrew).
+- `docs` — Print bundled CLI documentation.
+- `mcp` — MCP server and bundle tools.
+- `http` — HTTP API server for tools.
+
+###### `full-example-json workspaces :id delete version`
+
+Print the program version.
+
+###### `full-example-json workspaces :id delete configure`
+
+Set up MCP config for this app (binary via Homebrew).
+
+> Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
+> 
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
+> 
+> After install or upgrade:
+>   full-example-json configure install
+> 
+> Upgrade:
+>   brew upgrade full-example-json
+>   full-example-json configure install
+> 
+> Shell completions are installed by Homebrew during brew install.
+> See: https://docs.brew.sh/Shell-Completion
+> 
+> See what is installed:
+>   full-example-json configure status
+> 
+> Uninstall:
+>   full-example-json configure uninstall
+>   brew uninstall <tap>/full-example-json
+> 
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+###### `full-example-json workspaces :id delete configure install`
+
+Install agent artifacts and bootstrap app config.
+
+###### `full-example-json workspaces :id delete configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+###### `full-example-json workspaces :id delete configure status`
+
+Print what is currently installed (read-only).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
+
+###### `full-example-json workspaces :id delete docs`
+
+Print bundled CLI documentation.
+
+> Topics print to stdout. Add --save to write files under ./docs/.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+#### Subcommands
+
+- `readme` — Print README (user guide).
+- `mcp` — Print MCP server setup and tool guidance.
+- `http` — Print HTTP API setup and tool guidance.
+- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
+- `cli-schema` — Print the full CLI command tree as JSON.
+- `cli` — Print the full command reference as markdown.
+
+###### `full-example-json workspaces :id delete docs readme`
+
+Print README (user guide).
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id delete docs mcp`
+
+Print MCP server setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id delete docs http`
+
+Print HTTP API setup and tool guidance.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id delete docs openapi`
+
+Print the HTTP OpenAPI 3.1 document as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id delete docs cli-schema`
+
+Print the full CLI command tree as JSON.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id delete docs cli`
+
+Print the full command reference as markdown.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--save` | flag | optional | — | Write documentation to ./docs/. |
+
+###### `full-example-json workspaces :id delete mcp`
+
+MCP server and bundle tools.
+
+> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
+> 
+>   command: full-example-json
+>   args: mcp
+> 
+> Or:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs mcp
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |
+
+#### Subcommands
+
+- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces :id delete mcp bundle`
+
+Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
+
+###### `full-example-json workspaces :id delete http`
+
+HTTP API server for tools.
+
+> HTTP tool server on http://127.0.0.1:3000.
+> 
+> Endpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*
+> 
+> Configure app settings:
+> 
+>   full-example-json configure
+> 
+> Full setup guide: full-example-json docs http
+
+**Default subcommand:** `serve` (`missingOnly`)
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--host` | string | optional | — | Listen host. |
+| `--port` | number | optional | — | Listen port. |
+| `--trust-proxy` | flag | optional | — | Honor X-Forwarded-For for client IP. |
+| `--obscure-errors` | flag | optional | — | Hide unexpected errors from clients. |
+| `--log-format` | enum (`json`, `text`) | optional | — | Log format: json (ECS Logging) or text. |
+| `--log-file` | string | optional | — | Append logs to this file (relative → app config dir). |
+| `--no-access-log` | flag | optional | — | Disable HTTP access logs. |
+| `--dev` | flag | optional | — | Print full stacks to stderr on errors. |