@wirecat/cli-template 0.15.0 → 0.16.0

package/docs/commands.md

@@ -53,15 +53,165 @@ clidev commands info [path]
 
 **Example:** `clidev commands info commands`
 
+## `clidev session`
+
+keep this profile's Example Comments token in the OS keyring
+
+### `clidev session start`
+
+sign this profile in: the Example Comments API token is asked hidden or read from stdin, never taken as an argument, checked against the service, and only then kept in the keyring, or in a private file
+
+**Changes something on this computer only.**
+
+```sh
+clidev session start [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--credential-storage <storage>` | where the token is kept: keyring, which falls back to a private file by itself, or file. Default: `keyring`. |
+
+**Returns:** sign in to Example Comments with an API token
+
+**Example:** `clidev personal session start`, `clidev personal session start --credential-storage file`
+
+### `clidev session status`
+
+show where this profile's token comes from: CLIDEV_TOKEN, the keyring or a file, never the token; --check asks Example Comments whose token it is
+
+```sh
+clidev session status [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--check` | ask Example Comments whether the token still works, and whose it is. |
+
+**Returns:** show where this profile's token comes from; never the token
+
+**Example:** `clidev personal session status`, `clidev personal session status --check --json`
+
+### `clidev session end`
+
+forget this profile's token on this computer; the token itself stays valid in Example Comments
+
+**Changes something on this computer only.**
+
+```sh
+clidev session end
+```
+
+**Returns:** forget this profile's token on this computer
+
+**Example:** `clidev personal session end`
+
+### `clidev session list`
+
+list the profiles on this computer and whether each has a token; picks none
+
+```sh
+clidev session list
+```
+
+**Returns:** list the profiles here and whether each is signed in
+
+**Example:** `clidev session list`, `clidev session list --json`
+
+## `clidev comments`
+
+read and write comments in Example Comments, the sample service
+
+### `clidev comments list`
+
+list the comments in Example Comments, newest first
+
+```sh
+clidev comments list [query] [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `query` | optional | field:value terms that narrow the list — the fields are below. |
+
+| Option | What it does |
+|---|---|
+| `--limit <n>` | how many to show. |
+| `--page <n>` | which page, starting at 1. |
+| `--all` | every row, no paging. |
+
+**Returns:** comment — id, text, author, created_at; every field: clidev commands info comments list
+
+**Example:** `clidev personal comments list`, `clidev personal comments list author:u2 --json=id,text`
+
+### `clidev comments show`
+
+show one comment in Example Comments
+
+```sh
+clidev comments show <id>
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `id` | required | the comment's id, as list prints it. |
+
+**Returns:** comment — id, text, author, created_at; every field: clidev commands info comments show
+
+**Example:** `clidev personal comments show c1`, `clidev personal comments show c1 --json`
+
+### `clidev comments create`
+
+post a comment in Example Comments
+
+**Changes something in the service.**
+
+```sh
+clidev comments create [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--text <text>` | the comment's text. |
+
+**Returns:** post a comment in Example Comments
+
+**Example:** `clidev personal comments create --text "Looks good to me"`, `clidev personal comments create --text "Looks good to me" --dry-run`
+
+### `clidev comments update`
+
+change the text of your comment in Example Comments
+
+**Changes something in the service.**
+
+```sh
+clidev comments update <id> [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `id` | required | the comment's id, as list prints it. |
+
+| Option | What it does |
+|---|---|
+| `--text <text>` | the new text. |
+
+**Returns:** change the text of your comment in Example Comments
+
+**Example:** `clidev personal comments update c1 --text "Looks good now"`
+
 ## `clidev doctor`
 
-check this installation: version, paths, config, profiles; no keyring or network
+the state this installation is in, without connecting unless --online
 
 ```sh
-clidev doctor
+clidev doctor [options]
 ```
 
-**Returns:** check this installation: version, paths, config, profiles; no keyring or network
+| Option | What it does |
+|---|---|
+| `--online` | also connect once and read the account; sends nothing. |
+
+**Returns:** the state this installation is in, without connecting unless --online
 
 **Example:** `clidev doctor`, `clidev doctor --json`
 
@@ -117,11 +267,11 @@ clidev skill status
 
 ## `clidev mcp`
 
-serve this profile's commands to an agent over MCP — `claude mcp add clidev -- clidev personal mcp serve`
+serve this profile to an agent over MCP and set it up — `claude mcp add clidev -- clidev <profile> mcp serve`
 
 ### `clidev mcp serve`
 
-serve this profile's commands to an agent over MCP, on stdin and stdout, writes included; the profile's permissions decide — `claude mcp add clidev -- clidev personal mcp serve`
+serve this profile to an agent over MCP, on stdin and stdout — `claude mcp add clidev -- clidev <profile> mcp serve`; `clidev mcp serve --profiles a,b` or `--profiles all` serves those profiles from one server and each tool asks which
 
 **Changes something in the service.**
 
@@ -131,27 +281,33 @@ clidev mcp serve [options]
 
 | Option | What it does |
 |---|---|
+| `--permission <key=level>` | make a permission stricter for this server only, like comments.create=deny; it never loosens the profile; repeat for more keys. |
+| `--profiles <names\|all>` | serve several profiles from one server instead of one: names, comma-separated, or all for every profile. |
 | `--http` | serve over HTTP on 127.0.0.1 for ChatGPT and Claude in the browser, behind your tunnel; the profile's permissions decide. |
 | `--port <port>` | the local port for --http (default 8765). |
-| `--public-url <url>` | the tunnel's https address the browser apps use, e.g. https://<name>.ts.net. |
+| `--public-url <url>` | the tunnel's https address the browser apps use, e.g. https://<name>.ts.net or https://<name>.ts.net/tg. |
 
 **Returns:** serve this profile's commands to an AI agent
 
-**Example:** `clidev personal mcp serve`, `clidev personal mcp serve --http --public-url https://laptop.example.ts.net`
+**Example:** `clidev personal mcp serve`, `clidev mcp serve --profiles work,personal`, `clidev personal mcp serve --http --public-url https://laptop.example.ts.net`
 
 ### `clidev mcp revoke`
 
-forget every login `mcp serve --http` gave a browser app; each must log in again
+forget every login `mcp serve --http` gave a browser app, of this profile or of the server `--profiles` names; each app must log in again
 
 **Changes something on this computer only.**
 
 ```sh
-clidev mcp revoke
+clidev mcp revoke [options]
 ```
 
+| Option | What it does |
+|---|---|
+| `--profiles <names\|all>` | serve several profiles from one server instead of one: names, comma-separated, or all for every profile. |
+
 **Returns:** forget every login given to a browser app
 
-**Example:** `clidev personal mcp revoke`
+**Example:** `clidev personal mcp revoke`, `clidev mcp revoke --profiles all`
 
 ### `clidev mcp server`
 
@@ -171,6 +327,8 @@ clidev mcp server start [options]
 |---|---|
 | `--port <port>` | the local port (default 8765). |
 | `--public-url <url>` | the tunnel's https address the browser apps use, e.g. https://<name>.ts.net or https://<name>.ts.net/tg. |
+| `--permission <key=level>` | make a permission stricter for this server only; repeat for more keys. |
+| `--profiles <names\|all>` | the server of several profiles that `mcp serve --profiles` serves: names, comma-separated, or all. |
 
 **Returns:** start the HTTP MCP server in the background
 
@@ -183,9 +341,13 @@ stop `mcp serve --http` — only one that `mcp server start` started
 **Changes something on this computer only.**
 
 ```sh
-clidev mcp server stop
+clidev mcp server stop [options]
 ```
 
+| Option | What it does |
+|---|---|
+| `--profiles <names\|all>` | the server of several profiles that `mcp serve --profiles` serves: names, comma-separated, or all. |
+
 **Returns:** stop the background HTTP MCP server
 
 **Example:** `clidev personal mcp server stop`
@@ -195,13 +357,73 @@ clidev mcp server stop
 whether `mcp serve --http` runs, on which port and address, the login code for a new browser app, and the apps logged in
 
 ```sh
-clidev mcp server status
+clidev mcp server status [options]
 ```
 
+| Option | What it does |
+|---|---|
+| `--profiles <names\|all>` | the server of several profiles that `mcp serve --profiles` serves: names, comma-separated, or all. |
+
 **Returns:** whether the HTTP MCP server runs, its login code and the apps logged in
 
 **Example:** `clidev personal mcp server status --json`
 
+### `clidev mcp config`
+
+print the mcpServers entry for Claude Desktop, Cursor and others, with full paths; writes nothing
+
+```sh
+clidev mcp config [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--permission <key=level>` | make a permission stricter for this server only, like comments.create=deny; it never loosens the profile; repeat for more keys. |
+| `--profiles <names\|all>` | serve several profiles from one server instead of one: names, comma-separated, or all for every profile. |
+
+**Returns:** print the local MCP configuration of this profile, or of those --profiles names
+
+**Example:** `clidev personal mcp config`, `clidev mcp config --profiles all`
+
+### `clidev mcp add`
+
+add this profile's local MCP server to Codex or Claude Code
+
+**Changes something on this computer only.**
+
+```sh
+clidev mcp add <client> [options]
+```
+
+| Argument | | What it is |
+|---|---|---|
+| `client` | required | codex or claude-code. |
+
+| Option | What it does |
+|---|---|
+| `--allow-writes` | acknowledge that this profile offers writing tools. |
+| `--permission <key=level>` | make a permission stricter for this server only, like comments.create=deny; it never loosens the profile; repeat for more keys. |
+
+**Returns:** add this profile's local MCP server to Codex or Claude Code
+
+**Example:** `clidev personal mcp add codex --allow-writes`
+
+### `clidev mcp check`
+
+check this profile's local MCP handshake and tool list
+
+```sh
+clidev mcp check [options]
+```
+
+| Option | What it does |
+|---|---|
+| `--permission <key=level>` | make a permission stricter for this server only, like comments.create=deny; it never loosens the profile; repeat for more keys. |
+
+**Returns:** check this profile's local MCP handshake and tool list
+
+**Example:** `clidev personal mcp check`
+
 ## `clidev upgrade`
 
 upgrade clidev with the package manager that installed it; --check only looks

package/docs/configuration.md

@@ -21,6 +21,6 @@ the permissions say.
 
 A command that fails is kept as a run, for `clidev runs list` and `runs show`. A command you add that does its work
 in `context.run` is kept when it succeeds too, unless `record` is `false` (then only failures) or it ran with
-`--no-record`. The skeleton's own commands only read local files and open no run. `record_input` decides whether a run
+`--no-record`. `comments` and `session status --check` do their work in a run, so `--record` keeps them. `record_input` decides whether a run
 keeps the words you typed; it is `true` unless you set it to `false`. Secrets are masked either way; see
 [Security](security.md).

package/docs/dev/reference-clis.md

@@ -1,7 +1,8 @@
 # Reference CLIs
 
-The template has no sample code. The agent that builds a new CLI learns from the WireCat CLI closest to it, picked by
-the first question of the [design interview](skills/design-interview/SKILL.md):
+How a command reaches a service, signs in, writes and is tested, the agent learns from the template's sample (see
+"The sample" in `AGENTS.md`). The domain, the store and its commands it learns from the WireCat CLI closest to it,
+picked by the first question of the [design interview](skills/design-interview/SKILL.md):
 
 | Category | Learn from |
 | --- | --- |

package/docs/dev/test-matrix.md

@@ -7,28 +7,59 @@ ran it · ⛔ not tested offline, with the reason and where it is checked instea
 Measured from the test run (`coverage/argv.jsonl`), not searched for — see
 [TESTING.md](TESTING.md) for how, and for the states and failures that cut across commands.
 
-**54 ✅ · 6 ⛔ · 0 ❌** — 21 commands, 39 options.
+**71 ✅ · 20 ⛔ · 0 ❌** — 32 commands, 59 options.
 
 | Command | Option | | Note |
 |---|---|---|---|
 | `commands` |  | ✅ |  |
 | `commands info` |  | ✅ |  |
+| `session start` |  | ✅ |  |
+| `session start` | `--credential-storage` | ✅ |  |
+| `session status` |  | ✅ |  |
+| `session status` | `--check` | ✅ |  |
+| `session end` |  | ✅ |  |
+| `session list` |  | ✅ |  |
+| `comments list` |  | ✅ |  |
+| `comments list` | `--limit` | ✅ |  |
+| `comments list` | `--page` | ✅ |  |
+| `comments list` | `--all` | ✅ |  |
+| `comments show` |  | ✅ |  |
+| `comments create` |  | ✅ |  |
+| `comments create` | `--text` | ✅ |  |
+| `comments update` |  | ✅ |  |
+| `comments update` | `--text` | ✅ |  |
 | `doctor` |  | ✅ |  |
+| `doctor` | `--online` | ✅ |  |
 | `skill show` |  | ✅ |  |
 | `skill show` | `--for` | ✅ |  |
 | `skill install` |  | ✅ |  |
 | `skill install` | `--for` | ✅ |  |
 | `skill status` |  | ✅ |  |
 | `mcp serve` |  | ✅ |  |
-| `mcp serve` | `--http` | ✅ |  |
-| `mcp serve` | `--port` | ✅ |  |
-| `mcp serve` | `--public-url` | ✅ |  |
+| `mcp serve` | `--permission` | ✅ |  |
+| `mcp serve` | `--profiles` | ✅ |  |
+| `mcp serve` | `--http` | ⛔ | starts an HTTP server or a background process that runs until stopped; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
+| `mcp serve` | `--port` | ⛔ | starts an HTTP server or a background process that runs until stopped; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
+| `mcp serve` | `--public-url` | ⛔ | starts an HTTP server or a background process that runs until stopped; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
 | `mcp revoke` |  | ✅ |  |
+| `mcp revoke` | `--profiles` | ⛔ | cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
 | `mcp server start` |  | ⛔ | starts a detached `mcp serve --http` from the built entry; cli-core tests mcpServerCommand, and the background run was checked by hand against dist/ |
 | `mcp server start` | `--port` | ⛔ | starts a detached `mcp serve --http` from the built entry; cli-core tests mcpServerCommand, and the background run was checked by hand against dist/ |
 | `mcp server start` | `--public-url` | ⛔ | starts a detached `mcp serve --http` from the built entry; cli-core tests mcpServerCommand, and the background run was checked by hand against dist/ |
+| `mcp server start` | `--permission` | ⛔ | starts a detached `mcp serve --http` from the built entry; cli-core tests mcpServerCommand, and the background run was checked by hand against dist/ |
+| `mcp server start` | `--profiles` | ⛔ | starts a detached `mcp serve --http` from the built entry; cli-core tests mcpServerCommand, and the background run was checked by hand against dist/ |
 | `mcp server stop` |  | ⛔ | stops the detached server that `mcp server start` wrote a pid file for; cli-core tests mcpServerCommand, and no live scenario starts a server to stop |
-| `mcp server status` |  | ✅ |  |
+| `mcp server stop` | `--profiles` | ⛔ | stops the detached server that `mcp server start` wrote a pid file for; cli-core tests mcpServerCommand, and no live scenario starts a server to stop |
+| `mcp server status` |  | ⛔ | starts an HTTP server or a background process that runs until stopped; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
+| `mcp server status` | `--profiles` | ⛔ | starts an HTTP server or a background process that runs until stopped; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
+| `mcp config` |  | ✅ |  |
+| `mcp config` | `--permission` | ✅ |  |
+| `mcp config` | `--profiles` | ✅ |  |
+| `mcp add` |  | ⛔ | writes Codex's or Claude Code's own MCP settings; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
+| `mcp add` | `--allow-writes` | ⛔ | writes Codex's or Claude Code's own MCP settings; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
+| `mcp add` | `--permission` | ⛔ | writes Codex's or Claude Code's own MCP settings; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
+| `mcp check` |  | ⛔ | starts the installed CLI as a child process, as the agent would; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
+| `mcp check` | `--permission` | ⛔ | starts the installed CLI as a child process, as the agent would; cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs this CLI's own server, config, revoke and refusals |
 | `upgrade` |  | ✅ |  |
 | `upgrade` | `--check` | ✅ |  |
 | `config show` |  | ✅ |  |

package/docs/index.md

@@ -1,7 +1,8 @@
 # clidev
 
-`clidev` is a WireCat command-line tool for the terminal, for scripts and for AI agents. It does not connect to a
-service yet.
+`clidev` is a WireCat command-line tool for the terminal, for scripts and for AI agents. Its one service is a sample,
+Example Comments, made up to show how a command reaches a service; its address never resolves.
 
-It has the commands every WireCat CLI shares: `doctor`, `commands`, `config`, `skill`, `mcp`, `runs` and `upgrade`.
+It has the commands every WireCat CLI shares: `doctor`, `commands`, `config`, `skill`, `mcp`, `runs` and `upgrade`,
+and the sample's `session` and `comments`.
 Start with [installation](installation.md), then [usage](usage.md).

package/docs/security.md

@@ -3,8 +3,10 @@
 What WireCat CLIs share — the keyring, permissions, MCP and what never reaches a log — is on the
 [shared security page](https://wirecat.dev/en/docs/security). This page keeps only what is particular to `clidev`.
 
-`clidev` keeps its settings in `config.json` and its state in the folders `clidev doctor` shows. It sends nothing
-to any service yet.
+`clidev` keeps its settings in `config.json` and its state in the folders `clidev doctor` shows. Its one service is
+the sample, Example Comments, whose address never resolves. `session start` keeps the service's token in the OS
+keyring, or in a private file where no keyring works; the token goes only into the request's Authorization header,
+never into an address, an answer, a run record or the send journal.
 
 `clidev personal mcp serve --http` listens on `127.0.0.1` only, for browser apps that reach it through your own
 tunnel. Each app logs in with a one-time code, and the server keeps a hash of each login it gives, in the state

package/kit/dist/new.js

@@ -113,12 +113,14 @@ export const designDoc = (names, answers) => {
         "Delete this section once every step is done (WC-DOC-3).",
         "",
         "1. If an answer below is missing, ask the owner the [design interview](skills/design-interview/SKILL.md).",
-        "2. Learn from the reference CLI below: its provider, its store and its commands.",
+        '2. Learn how a command reaches a service from the sample (`AGENTS.md`, "The sample"), and the domain, the',
+        "   store and its commands from the reference CLI below. Build the first command on the sample.",
         "3. Ask the further questions in the interview that the reference CLI does not answer, and write the answers here.",
         "   Build only after the owner has read this page.",
         "4. When the first command reaches the service, rewrite `README.md`, `docs/index.md` and the description in",
-        `   \`package.json\` and \`skills/${names.name}/SKILL.md\` to say what the tool does and who it is for. Rewrite the`,
-        "   MCP server's instructions in `src/mcp.ts` too: name the kinds of outside text the CLI carries (WC-MCP-11).",
+        `   \`package.json\` and \`skills/${names.name}/SKILL.md\` to say what the tool does and who it is for. Rewrite`,
+        "   `appMcpCommand`'s `name` and `untrusted` in `src/program.ts` too: name the kinds of outside text the CLI",
+        "   carries (WC-MCP-11).",
         "",
         "## Answers",
         "",
@@ -298,6 +300,7 @@ export const runNew = async (cwd, source, args, io) => {
         "Next:",
         `  cd ${names.name}`,
         "  pnpm install",
+        "  pnpm lint:fix",
         "  pnpm ci:quick",
         "  git add -A",
         '  git commit -m "chore: start from @wirecat/cli-template"',

package/lint/overrides.json

@@ -1 +1,9 @@
-[]
+[
+  {
+    "rule": "list-without-query",
+    "target": "session list",
+    "reason": "Lists the few profiles on this computer, every one at once by design (WC-ACCT-12), as gcal-cli's session list does; a filter would let a caller narrow it to one and read that as the only profile.",
+    "owner": "@WireCatLabs",
+    "review_after": "2027-05-06"
+  }
+]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-template",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Start a new WireCat CLI: a working skeleton on cli-base and cli-core, copied by new and kept current by upgrade",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -86,17 +86,16 @@
     "kit:docs": "cspell lint --config cspell.json --no-progress --no-summary kit/*.md && rumdl check --config config/wirecat/rumdl.toml kit/*.md"
   },
   "dependencies": {
-    "@modelcontextprotocol/server": "2.4.0",
     "@wirecat/cli-base": "0.77.1",
     "@wirecat/cli-core": "0.584.0",
-    "commander": "15.0.0"
+    "commander": "15.0.0",
+    "valibot": "1.5.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.6.3",
     "@cspell/dict-en-gb": "5.0.38",
     "@cspell/dict-es-es": "3.0.9",
     "@cspell/dict-ru_ru": "2.3.4",
-    "@modelcontextprotocol/client": "2.4.0",
     "@types/node": "22.20.5",
     "@vitest/coverage-v8": "5.0.5",
     "@wirecat/cli-testing": "0.5.3",

package/scripts/test-matrix-untested.ts

@@ -1,3 +1,8 @@
+const SHARED_MCP =
+  "cli-core's appMcpCommand; its app-mcp-command and mcp-server-command tests drive it, and src/mcp.test.ts runs " +
+  "this CLI's own server, config, revoke and refusals"
+const LONG_RUNNING = `starts an HTTP server or a background process that runs until stopped; ${SHARED_MCP}`
+
 export const UNTESTED: { command: string; option?: string; reason: string }[] = [
   {
     command: "",
@@ -31,4 +36,18 @@ export const UNTESTED: { command: string; option?: string; reason: string }[] =
     reason:
       "stops the detached server that `mcp server start` wrote a pid file for; cli-core tests mcpServerCommand, and no live scenario starts a server to stop",
   },
+  ...["--http", "--port", "--public-url"].map((option) => ({ command: "mcp serve", option, reason: LONG_RUNNING })),
+  { command: "mcp server status", reason: LONG_RUNNING },
+  { command: "mcp server status", option: "--profiles", reason: LONG_RUNNING },
+  { command: "mcp revoke", option: "--profiles", reason: SHARED_MCP },
+  ...[undefined, "--allow-writes", "--permission"].map((option) => ({
+    command: "mcp add",
+    ...(option ? { option } : {}),
+    reason: `writes Codex's or Claude Code's own MCP settings; ${SHARED_MCP}`,
+  })),
+  ...[undefined, "--permission"].map((option) => ({
+    command: "mcp check",
+    ...(option ? { option } : {}),
+    reason: `starts the installed CLI as a child process, as the agent would; ${SHARED_MCP}`,
+  })),
 ]

package/skills/clidev-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: clidev-cli
-description: Use clidev, a WireCat CLI started from cli-template, from an agent — find a command, run it with the owner's profile, read JSON answers. Use when a task needs clidev. It does not connect to a service yet.
+description: Use clidev, a WireCat CLI started from cli-template, from an agent — find a command, run it with the owner's profile, read JSON answers. Use when a task needs clidev. Its one service is a made-up sample, Example Comments.
 metadata:
   openclaw:
     requires: