argsbarg 6.1.9 → 6.2.0

package/examples/full-example/docs/http.md

@@ -1,3 +1,5 @@
+<!-- Generated by full-example docs http --save; do not edit. -->
+
 # HTTP API (full-example)
 
 full-example exposes user commands over HTTP REST routes derived from the CLI tree.
@@ -10,7 +12,7 @@ full-example http
 
 Listens on **http://127.0.0.1:3000** by default (`httpServer.host` / `httpServer.port`).
 
-Bind is localhost-only in v0 — use a reverse proxy for remote access.
+Bind is localhost-only by default — use a reverse proxy for remote access.
 
 ## Endpoints
 
@@ -58,14 +60,7 @@ See the argsbarg [logging guide](https://github.com/bdombro/bun-argsbarg/blob/ma
 ## REST routes
 
 - `POST /echo` (CLI: `full-example echo`) — Echo a message (MCP-friendly leaf).
-- `POST /render-json` (CLI: `full-example render-json`) — Echo a JSON message (schema-first JSON leaf demo).
 - `POST /status` (CLI: `full-example status`) — Show app version. (flags: --json)
-- `GET /workspaces` (CLI: `full-example workspaces get`) — List workspaces.
-- `POST /workspaces` (CLI: `full-example workspaces post`) — Create a workspace.
-- `GET /workspaces/{id}` (CLI: `full-example workspaces :id get`) — Get one workspace.
-- `PUT /workspaces/{id}` (CLI: `full-example workspaces :id put`) — Replace a workspace.
-- `PATCH /workspaces/{id}` (CLI: `full-example workspaces :id patch`) — Patch a workspace name.
-- `DELETE /workspaces/{id}` (CLI: `full-example workspaces :id delete`) — Delete a workspace.
 
 ## Request bodies
 

package/examples/full-example/docs/mcp.md

@@ -6,83 +6,54 @@ full-example exposes an MCP server with features similar to the CLI.
 
 ## Installation
 
-### `configure`
+### `.agents` auto-install
 
-Install the CLI first so `full-example` is on your PATH (e.g. `brew install full-example`). Host configs reference the app by name.
+When `mcpServer.enabled` is set, `configure --sync` merges this server into `~/.agents/mcp.json` per the [.agents protocol](https://dotagentsprotocol.com/).
+
+Install the CLI first so `full-example` is on your PATH (e.g. `brew install full-example`).
 
 ```bash
 full-example configure --sync --yes
 ```
 
-Merges the server entry below into host config when each host is present:
-
-| Host | Config file |
-| --- | --- |
-| Cursor | `~/.cursor/mcp.json` (when `~/.cursor` exists) |
-| Claude Code | `~/.claude.json` |
-| Claude Desktop | `claude_desktop_config.json` (when Claude Desktop app data exists) |
-| OpenCode | `~/.config/opencode/*` (when `~/.config/opencode` exists) |
-| OpenAI Codex | `~/.codex/config.toml` via `codex mcp add` (when `codex` is on PATH) |
-| ChatGPT desktop | `chatgpt_mcp_config.json` (when ChatGPT app data exists) |
-
-Claude Desktop paths by platform:
-
-- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
-- **Linux:** `~/.config/Claude/claude_desktop_config.json`
-
-ChatGPT desktop JSON (when auto-installed):
+Writes or updates `~/.agents/mcp.json` with a `mcpServers` entry for this app.
 
-- **macOS:** `~/Library/Application Support/ChatGPT/chatgpt_mcp_config.json`
-- **Windows:** `%APPDATA%\OpenAI\ChatGPT\chatgpt_mcp_config.json`
+### Manual client setup
 
-Restart Claude Desktop and ChatGPT desktop after changing their config files.
-
-### Manual fallbacks
-
-**OpenCode** (no `~/.config/opencode` yet):
+Many clients do not read `~/.agents/mcp.json` yet. Copy the `mcpServers` entry from that file, or paste:
 
 ```json
 {
-  "$schema": "https://opencode.ai/config.json",
-  "mcp": {
+  "mcpServers": {
     "full_example": {
-      "type": "local",
-      "command": [
-        "full-example",
+      "command": "full-example",
+      "args": [
         "mcp"
-      ],
-      "enabled": true
+      ]
     }
   }
 }
 ```
 
-**Codex** (`codex` not on PATH):
-
-```toml
-[mcp_servers.full_example]
-command = "full-example"
-args = ["mcp"]
-```
-
-Or after installing Codex CLI: `codex mcp add full_example -- full-example mcp`.
-
-### ChatGPT web (Connectors)
+| Client | Config file |
+| --- | --- |
+| **Cursor** | `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project) |
+| **Claude Code** | `~/.claude.json` under `mcpServers`, or project `.mcp.json` |
+| **Claude Desktop** | See platform paths below |
 
-OpenAI's documented path for **ChatGPT web/desktop** is **Settings → Connectors → Developer mode** with a **remote HTTPS MCP URL** — not local stdio. ChatGPT does not spawn `full-example mcp` directly.
+Restart Cursor or reload MCP after editing. Restart Claude Desktop after config changes.
 
-For local stdio, bridge and tunnel, then register the HTTPS URL in Connectors:
+Claude Desktop config paths:
 
-1. Expose `full-example mcp` over HTTP (e.g. `mcp-remote`).
-2. Tunnel if needed (ngrok, Cloudflare Tunnel).
-3. Add the public URL as a custom connector.
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux:** `~/.config/Claude/claude_desktop_config.json`
 
-Desktop `chatgpt_mcp_config.json` is merged when the ChatGPT app is installed; support varies by build. Use Connectors when local JSON is absent or tools do not appear.
+On this machine (macOS/Linux): `/Users/briandombrowski/Library/Application Support/Claude/claude_desktop_config.json`
 
 ### Manual `mcpServers` entry
 
-For Cursor, Claude, and ChatGPT desktop JSON configs, add under `mcpServers`:
+Same shape as in `~/.agents/mcp.json`:
 
 ```json
 {
@@ -121,14 +92,7 @@ full-example mcp
 ## Exposed tools
 
 - `full-example echo` — echo — Echo a message (MCP-friendly leaf).
-- `full-example render-json` — render-json — Echo a JSON message (schema-first JSON leaf demo).
 - `full-example status` — status — Show app version. (flags: --json)
-- `full-example workspaces get` — workspaces get — List workspaces.
-- `full-example workspaces post` — workspaces post — Create a workspace.
-- `full-example workspaces :id get` — workspaces :id get — Get one workspace.
-- `full-example workspaces :id put` — workspaces :id put — Replace a workspace.
-- `full-example workspaces :id patch` — workspaces :id patch — Patch a workspace name.
-- `full-example workspaces :id delete` — workspaces :id delete — Delete a workspace.
 
 ## Tool arguments