# full-example — CLI API reference Argsbarg CLI copy template (MCP, HTTP, configure, skills; no schemagen) Machine-readable export: `full-example docs cli-schema` ## `full-example` Argsbarg CLI copy template (MCP, HTTP, configure, skills; no schemagen) #### Subcommands - `echo` — Echo a message (MCP-friendly leaf). - `status` — Show app version. ### `full-example 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 echo version` Print the program version. #### `full-example 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 configure install > > Upgrade: > brew upgrade full-example > full-example configure install > > Shell completions are installed by Homebrew during brew install. > See: https://docs.brew.sh/Shell-Completion > > See what is installed: > full-example configure status > > Uninstall: > full-example configure uninstall > brew uninstall /full-example > > 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 echo configure install` Install agent artifacts and bootstrap app config. ##### `full-example 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 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 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 echo docs readme` Print README (user guide). #### Options | Option | Type | Required | Format / default | Description | | --- | --- | --- | --- | --- | | `--save` | flag | optional | — | Write documentation to ./docs/. | ##### `full-example 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 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 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 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 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 echo mcp` MCP server and bundle tools. > Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop: > > command: full-example > args: mcp > > Or: > > full-example configure > > Full setup guide: full-example 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/. ##### `full-example echo mcp bundle` Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/. #### `full-example 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 configure > > Full setup guide: full-example 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 status` Show app version. #### Options | Option | Type | Required | Format / default | Description | | --- | --- | --- | --- | --- | | `--json` | flag | optional | — | Emit JSON. | #### 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 status version` Print the program version. #### `full-example 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 configure install > > Upgrade: > brew upgrade full-example > full-example configure install > > Shell completions are installed by Homebrew during brew install. > See: https://docs.brew.sh/Shell-Completion > > See what is installed: > full-example configure status > > Uninstall: > full-example configure uninstall > brew uninstall /full-example > > 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 status configure install` Install agent artifacts and bootstrap app config. ##### `full-example 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 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 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 status docs readme` Print README (user guide). #### Options | Option | Type | Required | Format / default | Description | | --- | --- | --- | --- | --- | | `--save` | flag | optional | — | Write documentation to ./docs/. | ##### `full-example 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 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 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 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 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 status mcp` MCP server and bundle tools. > Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop: > > command: full-example > args: mcp > > Or: > > full-example configure > > Full setup guide: full-example 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/. ##### `full-example status mcp bundle` Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/. #### `full-example 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 configure > > Full setup guide: full-example 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. |