@wirecat/cli-template 0.1.0 → 0.1.2

package/.github/workflows/ci.yml

@@ -24,11 +24,11 @@ jobs:
       pack: ${{ inputs.pack || false }}
       bun-run: pnpm build && pnpm smoke:bun
       cli: true
-      bin: app
+      bin: clidev
       platforms: ${{ inputs.pack || inputs.platforms || github.event_name == 'workflow_dispatch' }}
       platform-run: |
-        node dist/bin/app.js commands --json >/dev/null
-        node dist/bin/app.js doctor --json >/dev/null
+        node dist/bin/clidev.js commands --json >/dev/null
+        node dist/bin/clidev.js doctor --json >/dev/null
       # No version is on npm before the first release, so there is no earlier package to upgrade from.
       skip: |
         contracts:upgrade

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 Notable changes to `@wirecat/cli-template`. One section per version, newest first; versions follow
 [semantic versioning](https://semver.org), so before `1.0.0` the skeleton may still change.
 
+## 0.1.2 — 25.10.2026
+
+### Changed — may break callers
+
+- **The template's placeholder is `clidev`, not `app`.** Readers took `app` for a real command. The template's files
+  now say `clidev`, `clidev-cli`, `@wirecat/clidev-cli` and `WireCatLabs/clidev-cli`, and `new` replaces them with
+  your CLI's names as before. `clidev` is not cli-base's `cli-dev` tool, which `new` leaves alone. A CLI made from
+  0.1.0 or 0.1.1 upgrades cleanly: `upgrade` renames each template version with its own placeholders.
+
+### Fixed
+
+- **A CLI made by `new` has its command.** Its `package.json` had `"bin": {}`, so `npm install -g` installed nothing to
+  run. `new` now writes `"bin": { "<command>": "dist/bin/<command>.js" }`.
+
+## 0.1.1 — 25.10.2026
+
+### Fixed
+
+- **`npx @wirecat/cli-template new` works.** It stopped with `template.json lists ".gitignore", but the package has
+  no such file`, because npm renames `.gitignore` when it installs a package. The package now ships the file under
+  another name, and `new` and `upgrade` write it as `.gitignore`.
+- **`new` and `upgrade` work on Windows.** `new` now marks `bin/release` and the other scripts as executable in
+  git, so a CLI made on Windows can still run them on Linux and macOS. `upgrade` no longer reads every file as
+  edited when git checked it out with Windows line endings, and it downloads the earlier template version without
+  needing a shell for `npm`.
+
 ## 0.1.0 — 25.10.2026
 
 ### Added

package/CLAUDE.md

@@ -1,14 +1,14 @@
-# app — working rules
+# clidev — working rules
 
 The [WireCat CLI standards](node_modules/@wirecat/cli-base/docs/standards/README.md) apply here and win over this
-file; it keeps only the rules of `app` itself. Start with [AGENTS.md](AGENTS.md).
+file; it keeps only the rules of `clidev` itself. Start with [AGENTS.md](AGENTS.md).
 
 **What cli-core already does, this repository does not do again** — commands, the store, search, MCP and the
 permissions. A gap in cli-core is fixed in cli-core.
 
 ## Local rules
 
-None yet. Add a rule here only when it holds for `app` alone, and link the handbook rule it narrows.
+None yet. Add a rule here only when it holds for `clidev` alone, and link the handbook rule it narrows.
 
 ## Private working folder
 

package/README.md

@@ -1,6 +1,9 @@
-# app
+# clidev
 
-`app` is a command-line tool started from [cli-template](https://github.com/WireCatLabs/cli-template), the kit for
+`clidev` is a placeholder. `npx @wirecat/cli-template new` replaces it with your CLI's command word, and
+`clidev-cli` with your CLI's name. It is not `cli-dev`, the developer tool in cli-base.
+
+`clidev` is a command-line tool started from [cli-template](https://github.com/WireCatLabs/cli-template), the kit for
 new WireCat CLIs. It is a working skeleton: the shared root commands, the settings, the agent skill and the MCP
 server run, and every check of the WireCat standards passes. It does not connect to a service yet. Replace this page
 with the tool's own introduction once it does.
@@ -16,26 +19,26 @@ npx @wirecat/cli-template new cal-cli --command cal --package @wirecat/cal-cli -
 ```sh
 pnpm install
 pnpm build
-node dist/bin/app.js personal doctor
+node dist/bin/clidev.js personal doctor
 ```
 
 `personal` is the profile: a name you choose for one account. Every command that uses an account starts with it, and
-none is ever assumed. `APP_PROFILE=personal` does the same for a whole shell session.
+none is ever assumed. `CLIDEV_PROFILE=personal` does the same for a whole shell session.
 
 ## What you can do
 
 | Command | What it does |
 | --- | --- |
-| `app personal doctor` | Checks this installation: version, paths, settings and profiles, without the network |
-| `app commands --json` | Prints every command as JSON, for agents and scripts |
-| `app personal config show` | Shows each setting and where it came from |
-| `app skill install` | Installs the agent skill for Claude Code, Codex and Gemini CLI |
-| `app personal mcp` | Serves the profile's commands to an AI agent over MCP |
-| `app upgrade --check` | Says whether a newer version is on npm |
+| `clidev personal doctor` | Checks this installation: version, paths, settings and profiles, without the network |
+| `clidev commands --json` | Prints every command as JSON, for agents and scripts |
+| `clidev personal config show` | Shows each setting and where it came from |
+| `clidev skill install` | Installs the agent skill for Claude Code, Codex and Gemini CLI |
+| `clidev personal mcp` | Serves the profile's commands to an AI agent over MCP |
+| `clidev upgrade --check` | Says whether a newer version is on npm |
 
 ## For AI agents
 
-`app skill show` prints the rules an agent follows with this tool. `app personal mcp` serves every command to an
+`clidev skill show` prints the rules an agent follows with this tool. `clidev personal mcp` serves every command to an
 agent, writes included: the profile's permissions decide what runs. See [MCP and permissions](docs/usage.md#agents).
 
 ## Documentation

package/SECURITY.md

@@ -3,13 +3,13 @@
 Please report a security problem privately — never in a public issue:
 
 - by email: [hello@wirecat.dev](mailto:hello@wirecat.dev);
-- or through [GitHub's private vulnerability reporting](https://github.com/WireCatLabs/app-cli/security/advisories/new).
+- or through [GitHub's private vulnerability reporting](https://github.com/WireCatLabs/clidev-cli/security/advisories/new).
 
-Say what you saw, how to repeat it, and the version (`app --version`). Never send a token, a password or anyone's
+Say what you saw, how to repeat it, and the version (`clidev --version`). Never send a token, a password or anyone's
 private content.
 
-What `app` keeps on your computer: the [shared security page](https://wirecat.dev/en/docs/security) and
+What `clidev` keeps on your computer: the [shared security page](https://wirecat.dev/en/docs/security) and
 [docs/security.md](docs/security.md).
 
-Security audits of `app` follow the shared
+Security audits of `clidev` follow the shared
 [security method](https://github.com/WireCatLabs/cli-testing/tree/main/docs/security) in cli-testing.

package/config/wirecat/biome.base.json

@@ -120,6 +120,23 @@
         "!**/fixtures/**"
       ]
     },
+    {
+      "path": "./config/wirecat/no-sqlite-driver.grit",
+      "includes": [
+        "**",
+        "!**/*.test.*",
+        "!**/*.spec.*",
+        "!**/test/**",
+        "!**/tests/**",
+        "!**/__tests__/**",
+        "!**/fixtures/**",
+        "!**/testing/**",
+        "!**/scripts/**",
+        "!**/bench/**",
+        "!**/performance/**",
+        "!**/contracts/**"
+      ]
+    },
     {
       "path": "./config/wirecat/no-unbounded-spread.grit",
       "includes": [

package/config/wirecat/manifest.json

@@ -2,7 +2,7 @@
   "source": "https://github.com/WireCatLabs/community",
   "revision": "2b0f124f6375939bba10c28a7f091923323e9a13",
   "files": {
-    "biome.base.json": "5d265b71896cdb0454260fa8d897bd517f61de512f16831e5d5273f29775f9f3",
+    "biome.base.json": "63760337a2e68522ad75e0ba163635785a01ec34dbd3cf338a09a4145932cf2a",
     "cspell.json": "8241122ed4d461976a838099b265ef8f2689a066608257b6fdc250d9b49b58aa",
     "lefthook.yml": "2f65a2e3103006d43f6d6f0a07ab333c132286157763222a59a5a22676acd391",
     "markdownlint.json": "5ed7d6980054c539f3f3c0e47a090f1a725b15be2c486a769a836bc6cd48ad2d",
@@ -14,7 +14,8 @@
     "release-lock-info.mjs": "4abab1f01ceee7d4c709222e923c9a6fc634bcf7b8b64d745a9ac495993310e0",
     "release-lock.sh": "bef364092c4ab595f3b9b4130e23570c8306223228cdfa3e9384230f3b7f4a49",
     "rumdl.toml": "048b929176f13234324f5825d1e811397f1491b9cb6684a1953e268e2c2ed863",
-    "check.mjs": "34b266411eaab7707030915f645308e86784b1574b21fa44ca974861a90c9ce1"
+    "check.mjs": "34b266411eaab7707030915f645308e86784b1574b21fa44ca974861a90c9ce1",
+    "no-sqlite-driver.grit": "19e1f510a88ddd9df44d6db43c1c9b603c3e5bbec03a3f65305b72eac7f09389"
   },
   "packageManager": "pnpm@11.20.0",
   "node": ">=22",
@@ -29,6 +30,8 @@
   },
   "fileRevisions": {
     "release-lock.sh": "49e630a99d758e3e113749bef2049b258c7262e3",
-    "release-lock-info.mjs": "49e630a99d758e3e113749bef2049b258c7262e3"
+    "release-lock-info.mjs": "49e630a99d758e3e113749bef2049b258c7262e3",
+    "biome.base.json": "06c612c609d870f0ba00010612e0413f65340408",
+    "no-sqlite-driver.grit": "06c612c609d870f0ba00010612e0413f65340408"
   }
 }

package/config/wirecat/no-sqlite-driver.grit

@@ -0,0 +1,15 @@
+language js
+
+or {
+  `import $_ from $source`,
+  `import $source`,
+  `export { $_ } from $source`,
+  `export * from $source`,
+  `export * as $_ from $source`,
+  `export type { $_ } from $source`,
+  `import($source)`,
+  `require($source)`
+} where {
+  $source <: r"^[\"'`](?:node:sqlite|bun:sqlite|better-sqlite3|drizzle-orm)(?:/.*)?[\"'`]$",
+  register_diagnostic(span=$source, message="The shared store belongs to cli-core (WC-STORE-5): a CLI opens no SQLite driver and writes no SQL against it. Ask cli-core for a store method.", severity="error")
+}

package/contracts/help.snap

@@ -1,6 +1,6 @@
-app — a new WireCat CLI, started from cli-template
+clidev — a new WireCat CLI, started from cli-template
 
-Usage: app <profile> <command> [options]
+Usage: clidev <profile> <command> [options]
 Account commands start with your profile, a name you choose; none is ever assumed.
 
 Works with:
@@ -11,6 +11,6 @@ Works with:
   drive                   Google Drive and Docs as local text, searchable with your messages
   memo context <person>   one person across messengers, mail, notes and meetings
 
-Next:         app commands      every command, by section
-              app help options  output, offline, timeouts, dry run
-For agents:   app skill show    rules and the discovery loop
+Next:         clidev commands      every command, by section
+              clidev help options  output, offline, timeouts, dry run
+For agents:   clidev skill show    rules and the discovery loop

package/contracts/mcp-tools.json

@@ -18,7 +18,7 @@
           "type": "object"
         },
         "command": {
-          "description": "a command app_tools_search returned: \"messages list\"",
+          "description": "a command clidev_tools_search returned: \"messages list\"",
           "minLength": 1,
           "type": "string"
         }
@@ -26,7 +26,7 @@
       "required": ["command"],
       "type": "object"
     },
-    "name": "app_read",
+    "name": "clidev_read",
     "outputSchema": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "anyOf": [
@@ -464,7 +464,7 @@
       "required": [],
       "type": "object"
     },
-    "name": "app_tools_search",
+    "name": "clidev_tools_search",
     "outputSchema": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "properties": {},
@@ -492,7 +492,7 @@
           "type": "object"
         },
         "command": {
-          "description": "a command app_tools_search returned: \"messages list\"",
+          "description": "a command clidev_tools_search returned: \"messages list\"",
           "minLength": 1,
           "type": "string"
         }
@@ -500,7 +500,7 @@
       "required": ["command"],
       "type": "object"
     },
-    "name": "app_write",
+    "name": "clidev_write",
     "outputSchema": {
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "anyOf": [

package/contracts/plan.json

@@ -1,6 +1,6 @@
 {
   "command": "node",
-  "args": ["../dist/bin/app.js"],
+  "args": ["../dist/bin/clidev.js"],
   "cases": [
     {
       "id": "help",

package/cspell.json

@@ -6,5 +6,5 @@
     "@cspell/dict-ru_ru/cspell-ext.json"
   ],
   "ignorePaths": ["docs/dev/**", "CHANGELOG.md"],
-  "words": ["cyrillic", "latin", "wirecat"]
+  "words": ["clidev", "cyrillic", "latin", "wirecat"]
 }

package/dist/bin/clidev.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=clidev.d.ts.map

package/dist/bin/clidev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clidev.d.ts","sourceRoot":"","sources":["../../src/bin/clidev.ts"],"names":[],"mappings":""}

package/dist/bin/{app.js → clidev.js}

@@ -11,4 +11,4 @@ try {
 finally {
     stopCatching();
 }
-//# sourceMappingURL=app.js.map
+//# sourceMappingURL=clidev.js.map

package/dist/bin/clidev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clidev.js","sourceRoot":"","sources":["../../src/bin/clidev.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,kBAAkB,EAAE,CAAA;AACpB,MAAM,YAAY,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC,CAAA;AACxG,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;AAC7C,IAAI,CAAC;IACH,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACrD,CAAC;QAAS,CAAC;IACT,YAAY,EAAE,CAAA;AAChB,CAAC"}

package/dist/identity.d.ts

@@ -1,5 +1,5 @@
 import type { AppIdentity } from "@wirecat/cli-core/cli";
-export declare const PACKAGE = "@wirecat/app-cli";
+export declare const PACKAGE = "@wirecat/clidev-cli";
 export declare const IDENTITY: AppIdentity;
 export declare const SKILL: import("url").URL;
 //# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,eAAO,MAAM,OAAO,qBAAqB,CAAA;AAEzC,eAAO,MAAM,QAAQ,EAAE,WAOtB,CAAA;AAED,eAAO,MAAM,KAAK,mBAAyD,CAAA"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,eAAO,MAAM,OAAO,wBAAwB,CAAA;AAE5C,eAAO,MAAM,QAAQ,EAAE,WAOtB,CAAA;AAED,eAAO,MAAM,KAAK,mBAA4D,CAAA"}

package/dist/identity.js

@@ -1,12 +1,12 @@
 import { VERSION } from "./version.js";
-export const PACKAGE = "@wirecat/app-cli";
+export const PACKAGE = "@wirecat/clidev-cli";
 export const IDENTITY = {
-    command: "app",
-    appName: "app-cli",
-    envPrefix: "APP",
+    command: "clidev",
+    appName: "clidev-cli",
+    envPrefix: "CLIDEV",
     description: "a new WireCat CLI, started from cli-template",
     version: VERSION,
-    issues: "https://github.com/WireCatLabs/app-cli/issues/new",
+    issues: "https://github.com/WireCatLabs/clidev-cli/issues/new",
 };
-export const SKILL = new URL("../skills/app-cli/SKILL.md", import.meta.url);
+export const SKILL = new URL("../skills/clidev-cli/SKILL.md", import.meta.url);
 //# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,OAAO,GAAG,kBAAkB,CAAA;AAEzC,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,8CAA8C;IAC3D,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,mDAAmD;CAC5D,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,4BAA4B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA"}
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,OAAO,GAAG,qBAAqB,CAAA;AAE5C,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,YAAY;IACrB,SAAS,EAAE,QAAQ;IACnB,WAAW,EAAE,8CAA8C;IAC3D,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,sDAAsD;CAC/D,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,+BAA+B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0";
+export declare const VERSION = "0.1.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.1.0";
+export const VERSION = "0.1.2";
 //# sourceMappingURL=version.js.map

package/docs/commands.md

@@ -3,9 +3,9 @@
 # Commands
 
 Every command, option and exit code, generated from the program itself. For the same list as JSON, run
-`app commands --json`.
+`clidev commands --json`.
 
-**The first word is the profile**, a name you choose: `app personal doctor`. `APP_PROFILE`
+**The first word is the profile**, a name you choose: `clidev personal doctor`. `CLIDEV_PROFILE`
 does the same for a whole shell session. No profile is assumed: a command that uses an account stops without one and
 lists the profiles on this computer.
 
@@ -32,16 +32,16 @@ lists the profiles on this computer.
 | `--record` | keep this run — ids and timings, never message content. |
 | `--no-record` | do not keep it, whatever the configuration says. |
 
-## `app commands`
+## `clidev commands`
 
 every command by section; --json prints its contract, one path per call
 
-### `app commands info`
+### `clidev commands info`
 
 one command contract, or all schemas, error reasons and explicit overrides
 
 ```sh
-app commands info [path]
+clidev commands info [path]
 ```
 
 | Argument | | What it is |
@@ -50,30 +50,30 @@ app commands info [path]
 
 **Returns:** one command contract, or all schemas, error reasons and explicit overrides
 
-**Example:** `app commands info messages list`
+**Example:** `clidev commands info messages list`
 
-## `app doctor`
+## `clidev doctor`
 
 check this installation: version, paths, config, profiles; no keyring or network
 
 ```sh
-app doctor
+clidev doctor
 ```
 
 **Returns:** check this installation: version, paths, config, profiles; no keyring or network
 
-**Example:** `app personal doctor`, `app personal doctor --json`
+**Example:** `clidev personal doctor`, `clidev personal doctor --json`
 
-## `app skill`
+## `clidev skill`
 
 the instructions an agent is given for this tool
 
-### `app skill show`
+### `clidev skill show`
 
-print SKILL.md — `app skill install` puts it where Claude Code, Codex and Gemini CLI look for it
+print SKILL.md — `clidev skill install` puts it where Claude Code, Codex and Gemini CLI look for it
 
 ```sh
-app skill show [name]
+clidev skill show [name]
 ```
 
 | Argument | | What it is |
@@ -82,16 +82,16 @@ app skill show [name]
 
 **Returns:** print the tool's instructions for AI agents
 
-**Example:** `app skill show`, `app skill show follow-ups`
+**Example:** `clidev skill show`, `clidev skill show follow-ups`
 
-### `app skill install`
+### `clidev skill install`
 
-write SKILL.md to \~/.claude/skills/app-cli/ (Claude Code) and \~/.agents/skills/app-cli/ (Codex, Gemini CLI)
+write SKILL.md to \~/.claude/skills/clidev-cli/ (Claude Code) and \~/.agents/skills/clidev-cli/ (Codex, Gemini CLI)
 
 **Changes something on this computer only.**
 
 ```sh
-app skill install [options]
+clidev skill install [options]
 ```
 
 | Option | What it does |
@@ -100,50 +100,50 @@ app skill install [options]
 
 **Returns:** install the tool's instructions for AI agents
 
-**Example:** `app skill install --for agents`
+**Example:** `clidev skill install --for agents`
 
-## `app mcp`
+## `clidev mcp`
 
-serve this profile's commands to an agent over MCP, on stdin and stdout, writes included; the profile's permissions decide — `claude mcp add app -- app personal mcp`
+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`
 
 **Changes something in the service.**
 
 ```sh
-app mcp
+clidev mcp
 ```
 
 **Returns:** serve this profile's commands to an AI agent
 
-**Example:** `app personal mcp`
+**Example:** `clidev personal mcp`
 
-## `app upgrade`
+## `clidev upgrade`
 
-upgrade app with the package manager that installed it; --check only looks
+upgrade clidev with the package manager that installed it; --check only looks
 
 **Changes something on this computer only.**
 
 ```sh
-app upgrade [options]
+clidev upgrade [options]
 ```
 
 | Option | What it does |
 |---|---|
 | `--check` | say whether a newer version exists, and install nothing. |
 
-**Returns:** upgrade app with the package manager that installed it; --check only looks
+**Returns:** upgrade clidev with the package manager that installed it; --check only looks
 
-**Example:** `app upgrade --check`, `app upgrade`
+**Example:** `clidev upgrade --check`, `clidev upgrade`
 
-## `app config`
+## `clidev config`
 
 the settings in force, and where each one came from
 
-### `app config show`
+### `clidev config show`
 
 the profile, the profiles that exist, and each setting with where it came from
 
 ```sh
-app config show [options]
+clidev config show [options]
 ```
 
 | Option | What it does |
@@ -152,16 +152,16 @@ app config show [options]
 
 **Returns:** the profile, the profiles that exist, and each setting with where it came from
 
-**Example:** `app personal config show`
+**Example:** `clidev personal config show`
 
-### `app config set`
+### `clidev config set`
 
 save a setting to the configuration file
 
 **Changes something on this computer only.**
 
 ```sh
-app config set <setting> <value> [options]
+clidev config set <setting> <value> [options]
 ```
 
 | Argument | | What it is |
@@ -177,16 +177,16 @@ app config set <setting> <value> [options]
 
 **Returns:** save a setting to the configuration file
 
-**Example:** `app personal config set limit 20`
+**Example:** `clidev personal config set limit 20`
 
-### `app config unset`
+### `clidev config unset`
 
 remove a setting from the configuration file
 
 **Changes something on this computer only.**
 
 ```sh
-app config unset <setting> [options]
+clidev config unset <setting> [options]
 ```
 
 | Argument | | What it is |
@@ -201,7 +201,7 @@ app config unset <setting> [options]
 
 **Returns:** remove a setting from the configuration file
 
-**Example:** `app personal config unset limit`
+**Example:** `clidev personal config unset limit`
 
 ## Exit codes
 

package/docs/configuration.md

@@ -1,12 +1,12 @@
 # Settings
 
-Settings live in one file, `config.json`, in the folder `app personal doctor` shows. Each profile has its own part,
+Settings live in one file, `config.json`, in the folder `clidev personal doctor` shows. Each profile has its own part,
 and `defaults` apply to every profile. This page lists how to see and change them.
 
 ```sh
-app personal config show
-app personal config set limit 50
-app personal config unset limit
+clidev personal config show
+clidev personal config set limit 50
+clidev personal config unset limit
 ```
 
 `config show` lists each setting and where it came from: the file, a variable or the default.
@@ -14,5 +14,5 @@ app personal config unset limit
 ## Permissions
 
 `permissions` decides what a command may do for this profile: `allow`, `ask`, `readonly` or `deny`, per permission
-key. Over MCP there is no one to ask, so `ask` lets the command run. `APP_READ_ONLY=1` refuses every write, whatever
+key. Over MCP there is no one to ask, so `ask` lets the command run. `CLIDEV_READ_ONLY=1` refuses every write, whatever
 the permissions say.

package/docs/dev/skills/release/SKILL.md

@@ -15,9 +15,9 @@ and runs `bin/release`.
    left; report anything else and fix it in the release pull request.
 3. **The changelog.** Write `## Unreleased` under the handbook's headings, each at most once: `Added`,
    `Changed — may break callers`, `Fixed`, `Security`, `Removed` (`WC-DOC-14` to `WC-DOC-18`). No internal ids.
-4. **The docs.** `README.md`, `docs/*.md` and `skills/app-cli/SKILL.md` state what the code does now (`WC-DOC-3`).
+4. **The docs.** `README.md`, `docs/*.md` and `skills/clidev-cli/SKILL.md` state what the code does now (`WC-DOC-3`).
    `pnpm generate` and `pnpm test:matrix` rewrite the generated pages (`WC-DOC-4`).
-5. **The version.** `npm view @wirecat/app-cli version` is what is published. Set the next version in
+5. **The version.** `npm view @wirecat/clidev-cli version` is what is published. Set the next version in
    `package.json`, run `pnpm version:sync`, date the section as `## <version> — DD.MM.YYYY`, run
    `pnpm release:check` again, and open the pull request `chore(release): <version>`.
 6. **The owner** merges it and runs `bin/release` on a clean `main`. `bin/release --local` publishes from this

package/docs/dev/test-matrix.md

@@ -2,7 +2,7 @@
 
 # Test matrix
 
-Every command and option of `app`, and whether an offline test drives it through the CLI. ✅ a test
+Every command and option of `clidev`, and whether an offline test drives it through the CLI. ✅ a test
 ran it · ⛔ not tested offline, with the reason and where it is checked instead · ❌ nothing.
 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.

package/docs/index.md

@@ -1,6 +1,6 @@
-# app
+# clidev
 
-`app` brings a service to the terminal, to scripts and to AI agents. This page is where a reader starts: say what
+`clidev` brings a service to the terminal, to scripts and to AI agents. This page is where a reader starts: say what
 the tool does, who it is for, and the first command to run. It will say that once the tool connects to its service.
 
 Today it has the commands every WireCat CLI shares: `doctor`, `commands`, `config`, `skill`, `mcp` and `upgrade`.

package/docs/installation.md

@@ -1,16 +1,16 @@
 # Install
 
-Install `app` once on each computer where you or an agent use it. You need Node.js 22.16 or later, or 24.
+Install `clidev` once on each computer where you or an agent use it. You need Node.js 22.16 or later, or 24.
 
 ```sh
-npm install -g @wirecat/app-cli
-app --version
+npm install -g @wirecat/clidev-cli
+clidev --version
 ```
 
 Check the installation, then pick a profile name for your account, such as `personal`:
 
 ```sh
-app personal doctor
+clidev personal doctor
 ```
 
 `doctor` needs no network and opens no keyring. It shows the version, where settings live and the profiles that