@patze/code-cli 0.55.1 → 0.55.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +64 -198
  3. package/VERSION +1 -1
  4. package/docs/beta-release-handoff.md +1 -1
  5. package/docs/beta-tester-checklist.md +2 -2
  6. package/docs/install-beta.md +49 -30
  7. package/docs/known-limitations.md +1 -1
  8. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,13 @@ All notable changes to `@patze/code-cli` are documented here.
4
4
 
5
5
  Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
6
6
 
7
+ ## [0.55.2] - 2026-05-31
8
+
9
+ ### Docs
10
+
11
+ - **README** — Codex-style rewrite: install/start/auth only, accurate 0.55.x UI sample (clean composer), compact command list; moved maintainer tables to `docs/`.
12
+ - **`docs/install-beta.md`** + **`beta-tester-checklist.md`** — synced to 0.55.x; `--pair` install path; composer UX note.
13
+
7
14
  ## [0.55.1] - 2026-05-31
8
15
 
9
16
  ### Fixed (Codex-clean composer)
package/README.md CHANGED
@@ -1,248 +1,114 @@
1
1
  # Patze Code CLI
2
2
 
3
- Professional local terminal client for Patze Code / PatzeAgents.
3
+ Terminal coding agent for [PatzeAgents](https://github.com/patzelife/patzelife-plugin-agentdiscord). Runs in your workspace; server handles auth, policy, runs, and artifacts.
4
4
 
5
- Patze Code runs coding tasks against your workspace while keeping **PatzeAgents server** as the authority for auth, entitlements, run records, artifacts, verification, and policy.
5
+ **Internal beta** — install `@beta`, not `latest`. Details: [`docs/internal-beta.md`](docs/internal-beta.md).
6
6
 
7
- > **Internal beta (0.55.x):** Codex/cookbook-style composer, trust loop, runs automation, and gated agent execute. See [`docs/internal-beta.md`](docs/internal-beta.md) and [`docs/known-limitations.md`](docs/known-limitations.md). Not yet `npm latest` / 1.0.
7
+ ## Install
8
8
 
9
- ## Requirements
9
+ ```bash
10
+ npm install -g @patze/code-cli@beta
11
+ patze --version
12
+ ```
10
13
 
11
- - **Node.js** 20+
12
- - Patze API reachable from your machine (optional — for server-backed preview)
14
+ Pinned release: `@patze/code-cli@0.55.2`
13
15
 
14
- ## Install (internal beta)
16
+ Requires **Node.js 20+**.
15
17
 
16
- ```bash
17
- # Helper script (monorepo)
18
- cd packages/patze-code-cli
19
- ./scripts/install-beta.sh local
18
+ ## Start
20
19
 
21
- # Or manual tarball
22
- npm run build && npm pack
23
- npm install -g ./patze-code-cli-0.55.0.tgz
24
- patze --version
20
+ ```bash
21
+ cd your-project
22
+ patze
25
23
  ```
26
24
 
27
- Registry:
25
+ One-shot (non-interactive):
28
26
 
29
27
  ```bash
30
- npm install -g @patze/code-cli@beta
31
- # or pinned: @patze/code-cli@0.10.5
32
- patze --version
28
+ patze "summarize this repo in one paragraph"
29
+ patze exec "fix the typo in README" --json # JSONL stream for scripts
33
30
  ```
34
31
 
35
- Full guide: [`docs/install-beta.md`](docs/install-beta.md) · Checklist: [`docs/beta-tester-checklist.md`](docs/beta-tester-checklist.md)
32
+ ## Sign in
36
33
 
37
- ## Quick start (beta tester)
34
+ Agent tasks need Patze API credentials.
38
35
 
39
36
  ```bash
40
- # 1. Clean fixture workspace
41
- mkdir -p /tmp/patze-beta && cd /tmp/patze-beta
42
- git init
37
+ patze login --pair --api https://api.example.com
38
+ ```
43
39
 
44
- # 2. Optional — server auth (use env, never commit secrets)
45
- export PATZE_CODE_API=https://api.example.com
46
- export PATZE_CODE_TOKEN=<internal-api-key>
47
- export PATZE_CODE_USER_ID=<user-uuid>
40
+ Or inside the shell: `/login`. Manual: `patze login <api> <token> [userId]`.
48
41
 
49
- # Or dashboard pairing (recommended for humans)
50
- # patze login --pair --api https://api.example.com [--web https://app.example.com]
42
+ Env vars (optional): `PATZE_CODE_API`, `PATZE_CODE_TOKEN`, `PATZE_CODE_USER_ID`.
51
43
 
52
- # Optional — live Cursor model list in /model picker (OpenTUI + TTY)
53
- # export CURSOR_API_KEY=crsr_...
44
+ Optional: `CURSOR_API_KEY` adds live models to `/model` (bundled catalog always available).
54
45
 
55
- # 3. Read-only checks
56
- patze status
57
- patze doctor
58
- patze code inspect
59
- patze goal "Review README" --dry-run
46
+ ## What you see
60
47
 
61
- # 4. Interactive trust loop
62
- patze
63
- ```
64
-
65
- Running `patze` shows a status card and tips:
48
+ Compact header + empty composer (same idea as [Codex CLI](https://github.com/openai/codex)). Status lives in the header and transcript — not inside the input box.
66
49
 
67
50
  ```text
68
- ╭─ Patze Code · v0.55.0 ────────────────────────────────────╮
69
- │ workspace /mnt/d/pat-test │
70
- │ auth incomplete │
71
- │ permission Read-only │
72
- │ safety preview-first · read-only │
73
- ╰───────────────────────────────────────────────────────────╯
74
- Beta · Dev demo — for internal testing only
75
-
76
- ! auth incomplete — run `patze login --pair --api <url>` or set PATZE_CODE_* env
77
-
78
- Type a task, or /help for commands.
79
- Tips
80
- • /inspect scans the workspace (read-only)
81
- • /plan then /diff previews changes before any write
82
- • /apply needs typed approval — it never auto-applies
83
- Type / for commands · ↑↓ to navigate · Tab/Enter to select
84
-
85
- ›
51
+ >_ Patze Code (v0.55.2)
52
+ ╭────────────────────────────────────────╮
53
+ │ model Patze /model to change │
54
+ │ directory ~/your-project │
55
+ ╰────────────────────────────────────────╯
56
+ ⚠ Sign in to run agent tasks — /login or patze login
57
+
58
+ Describe a task, or type / for commands.
59
+ /help · /model · /reset · Ctrl+C cancels an active run
60
+
61
+ ╭────────────────────────────────────────╮
62
+ │ > _ │
63
+ ╰────────────────────────────────────────╯
64
+ Esc exit · Ctrl+C quit · Ctrl+U clear · / commands · ctrl+t thought · ctrl+d diff · /status
86
65
  ```
87
66
 
88
- Type `/` to open a live command palette that filters as you type:
67
+ Type `/` for the command palette (filter as you type, ↑↓ or j/k, Enter to run).
89
68
 
90
- ```text
91
- › /p
92
- /plan Server preview only (no apply)
93
- ❯ /permissions Open permission mode selector
94
- /help Show slash commands
95
- …
96
- ```
69
+ ## Commands
97
70
 
98
- Navigate with ↑↓, complete with Tab, run with Enter. Commands that need an
99
- argument (e.g. `/goal <task>`) complete to `/goal ` and wait for your input.
100
- When the palette is closed, ↑↓ recalls in-session history. The composer is
101
- TTY-only; piped / scripted input stays on readline and remains deterministic.
102
-
103
- Authenticate with **`patze login --pair --api <url>`** (dashboard device-code), **`/login`**
104
- inside the shell, or **`patze login <api> <token> [userId]`**. Environment variables
105
- `PATZE_CODE_API` / `PATZE_CODE_TOKEN` / `PATZE_CODE_USER_ID` also work. Tokens are
106
- masked in output and never kept in transcript or recall history.
107
-
108
- ## Cookbook parity ([Cursor coding-agent-cli](https://github.com/cursor/cookbook/tree/main/sdk/coding-agent-cli))
109
-
110
- Patze Code is a **PatzeAgents-backed** hybrid (server authority + Codex/cookbook UX):
111
-
112
- | Cookbook capability | Patze CLI |
113
- |---------------------|-----------|
114
- | Interactive TUI (`patze`) | ✅ OpenTUI (Bun) or Node TTY fallback |
115
- | One-shot + stdin pipe | ✅ `patze "task"`, `patze agent`, `patze exec` |
116
- | `/` slash menu (inline palette) | ✅ filter-as-you-type; composer stays focused |
117
- | `/local`, `/cloud`, `/model`, `/reset` | ✅ + Patze trust loop commands |
118
- | Model picker search + T/F prefs | ✅ OpenTUI + Node TTY |
119
- | Live model catalog | ✅ bundled + `Cursor.models.list` when `CURSOR_API_KEY` set |
120
- | Plain pipe feed (stderr meta) | ✅ Codex feed on `patze exec` / non-TTY agent |
121
- | Direct `@cursor/sdk` runtime | ⚠️ Patze uses FastAPI execute + policy (by design) |
122
-
123
- ## Command status (0.55.0)
124
-
125
- ### Interactive (`patze` shell)
126
-
127
- | Command | Status | Notes |
128
- |---------|--------|-------|
129
- | free-text prompt | ✅ | Agent execute + SSE when auth ready |
130
- | `/help` | ✅ | |
131
- | `/status [--check]` | ✅ | Trust-loop snapshot + auth posture |
132
- | `/login`, `/logout` | ✅ | Save or clear credentials |
133
- | `/local`, `/cloud` | ✅ | Execution mode (cloud gated by server) |
134
- | `/model` | ✅ | Searchable picker + T/F thinking/fast (TTY + OpenTUI) |
135
- | `/runs`, `/run` | ✅ | List/open/cancel server runs |
136
- | `/reset`, `/clear` | ✅ | Fresh agent / clear transcript |
137
- | `/context` | ✅ | Session state (digests masked) |
138
- | `/goal`, `/inspect`, `/plan` | ✅ | Trust loop + preview |
139
- | `/permissions`, `/tools` | ✅ | Mode selector + tool catalog |
140
- | `/diff`, `/approve`, `/apply`, `/verify`, `/reject` | ✅ | Gated local apply loop |
141
- | `/exit` | ✅ | |
142
-
143
- ### Top-level CLI
144
-
145
- | Command | Status | Notes |
146
- |---------|--------|-------|
147
- | `patze` | ✅ | Interactive shell (OpenTUI or Node TTY) |
148
- | `patze "<task>"` / `patze agent` | ✅ | One-shot agent; pipe uses Codex plain feed |
149
- | `patze exec "<task>" [--json]` | ✅ | CI/automation JSONL stream |
150
- | `patze --version` | ✅ | |
151
- | `patze status [--check]` | ✅ | |
152
- | `patze doctor [--check]` | ✅ | Read-only; e2e + cloud hints when dev env present |
153
- | `patze login --pair --api <url>` | ✅ | Dashboard device-code (recommended) |
154
- | `patze login <api> <token> [id]` | ✅ | Manual token paste |
155
- | `patze goal "<task>" --dry-run` | ✅ | Non-interactive plan |
156
- | `patze code inspect|plan|diff` | ✅ | Workspace / preview commands |
157
- | `patze code apply` | 🚫 disabled | Interactive `/apply` only |
158
- | `patze code verify` | ℹ️ help-only | No session apply → summary only |
159
- | `patze runs list|open|cancel` | ✅ | Server run history; `--json` on list/open |
160
- | `patze config` | ✅ | Resolved config paths + `web` URL |
161
-
162
- ### Permission modes
163
-
164
- | Mode | Status | Capabilities |
165
- |------|--------|--------------|
166
- | `read-only` | ✅ | inspect, plan, diff |
167
- | `suggest` | ✅ | + approval gate |
168
- | `edit-with-approval` | ✅ | + gated `/apply` |
169
- | `full-auto` | 🚫 forbidden | Never enabled |
170
-
171
- Legend: ✅ implemented · 🚫 explicitly disabled · ℹ️ informational only
172
-
173
- ## Trust loop
71
+ **Shell (`patze`)** — `/help`, `/status`, `/login`, `/logout`, `/model`, `/local`, `/cloud`, `/reset`, `/clear`, `/runs`, `/inspect`, `/goal`, `/plan`, `/diff`, `/permissions`, `/tools`, `/approve`, `/apply`, `/verify`, `/reject`, `/exit`
174
72
 
175
- ```
176
- prompt → inspect → plan → diff → permissions → approve → apply → verify
177
- ```
73
+ **CLI** — `patze status`, `patze doctor`, `patze config`, `patze runs list|open|cancel`, `patze goal … --dry-run`, `patze code inspect|plan|diff`
74
+
75
+ **Disabled by design** — `patze code apply` (use interactive `/apply`), `full-auto` permission mode
178
76
 
179
- Example inside `patze`:
77
+ ## Local apply (trust loop)
78
+
79
+ Preview first, then gated write:
180
80
 
181
81
  ```text
182
- /goal Update README quickstart
82
+ /goal <task>
183
83
  /plan
184
84
  /diff
185
- /permissions suggest
186
- /approve
187
85
  /permissions edit-with-approval
86
+ /approve
188
87
  /apply
189
- APPLY artifa…90ab
88
+ APPLY <masked-digest>
190
89
  /verify
191
- /status
192
90
  ```
193
91
 
194
- Docs: [`docs/trust-loop.md`](docs/trust-loop.md) · [`docs/safety-model.md`](docs/safety-model.md)
195
-
196
- ## Safety model (summary)
92
+ No auto-apply. No `--yes`. Verify does not run shell tests.
197
93
 
198
- - No auto-apply, no `--yes`, no shell execution from verify
199
- - Apply is interactive-only with explicit `APPLY <masked-digest>` confirmation
200
- - All session digests masked; tokens never printed in full
201
- - Verify fail-closed; drift recovery blocks stale approve/apply
202
- - **`full-auto` forbidden permanently**
94
+ More: [`docs/trust-loop.md`](docs/trust-loop.md) · [`docs/safety-model.md`](docs/safety-model.md)
203
95
 
204
- Full detail: [`docs/safety-model.md`](docs/safety-model.md)
96
+ ## Limits
205
97
 
206
- ## Development & release verify
207
-
208
- ```bash
209
- cd packages/patze-code-cli
210
- npm run verify # version + pack + typecheck + tests + smoke + PTY suite
211
- npm run verify:all # verify + gated verify:e2e (needs dev API up)
212
- npm run verify:pack # tarball audit (--verbose for JSON summary)
213
- npm run smoke # temp workspace + local npm pack install
214
- ```
215
-
216
- Optional live-agent checks (repo root API + `server/.env`):
217
-
218
- ```bash
219
- npm run verify:e2e # smart-agent smoke when /health is up
220
- npm run e2e:cloud # cloud preview → execute → SSE (GitHub origin required)
221
- npm run e2e:cloud:interactive # /cloud flow inside interactive shell
222
- npm run verify:ci-e2e-cloud # CI gate for cloud execute (skip when API/cloud flag absent)
223
- ```
98
+ Session transcript is in-memory. Cloud execute needs GitHub `origin` + server flag. Not production `latest` yet.
224
99
 
225
- ## Release blockers (before npm `latest` / 1.0)
100
+ Full list: [`docs/known-limitations.md`](docs/known-limitations.md)
226
101
 
227
- - [ ] Public npm publish policy + scoped access review
228
- - [ ] Shell-based verify (npm test/lint) as optional gated capability
229
- - [ ] Server apply receipt correlation (read-only)
230
- - [ ] Cross-restart session persistence decision
231
- - [ ] OAuth polish beyond `login --pair` (token refresh, production redirect UX)
232
- - [ ] Production error telemetry without leaking secrets
233
- - [x] Cloud execute e2e in CI (optional gated job `cloud-e2e-gated`; needs secrets + `FEATURE_PATZE_CODE_CLI_CLOUD_EXECUTE`)
102
+ ## More docs
234
103
 
235
- ## Documentation
104
+ | Topic | Doc |
105
+ |-------|-----|
106
+ | Install & testers | [`docs/install-beta.md`](docs/install-beta.md) |
107
+ | Architecture | [`docs/patze-cli-architecture.md`](docs/patze-cli-architecture.md) |
108
+ | Changelog | [`CHANGELOG.md`](CHANGELOG.md) |
236
109
 
237
- - Architecture: [`docs/patze-cli-architecture.md`](docs/patze-cli-architecture.md)
238
- - Internal beta: [`docs/internal-beta.md`](docs/internal-beta.md)
239
- - Install: [`docs/install-beta.md`](docs/install-beta.md)
240
- - Beta checklist: [`docs/beta-tester-checklist.md`](docs/beta-tester-checklist.md)
241
- - Feedback template: [`docs/beta-feedback-template.md`](docs/beta-feedback-template.md)
242
- - Known limits: [`docs/known-limitations.md`](docs/known-limitations.md)
243
- - Release checklist: [`docs/release-checklist.md`](docs/release-checklist.md)
244
- - Changelog: [`CHANGELOG.md`](CHANGELOG.md)
110
+ Maintainers: [`docs/beta-release-handoff.md`](docs/beta-release-handoff.md) · [`docs/release-checklist.md`](docs/release-checklist.md)
245
111
 
246
112
  ## License
247
113
 
248
- Proprietary — see [`NOTICE.md`](NOTICE.md).
114
+ Proprietary — [`NOTICE.md`](NOTICE.md)
package/VERSION CHANGED
@@ -1 +1 @@
1
- 0.55.1
1
+ 0.55.2
package/docs/beta-release-handoff.md CHANGED
@@ -95,7 +95,7 @@ npm install -g ./patze-code-cli-<version>.tgz
95
95
  ```bash
96
96
  npm install -g @patze/code-cli@beta
97
97
  # or pinned:
98
- npm install -g @patze/code-cli@0.55.0
98
+ npm install -g @patze/code-cli@0.55.2
99
99
 
100
100
  patze --version
101
101
  patze doctor
package/docs/beta-tester-checklist.md CHANGED
@@ -1,11 +1,11 @@
1
1
  # Beta tester checklist
2
2
 
3
- Use this before reporting feedback. Safety posture must match **0.10.1+** — no new mutation shortcuts.
3
+ Use this before reporting feedback. Safety posture matches **0.55.x** — no auto-apply, no `--yes`, no `full-auto`.
4
4
 
5
5
  ## Environment
6
6
 
7
7
  - [ ] Node 20+ (`node --version`)
8
- - [ ] `@patze/code-cli` 0.10.x (`patze --version`)
8
+ - [ ] `@patze/code-cli` 0.55.x (`patze --version`)
9
9
  - [ ] Clean git workspace for apply tests (`git init` in a temp dir is fine)
10
10
  - [ ] `patze doctor` — dist ok, trust loop posture lines present
11
11
 
package/docs/install-beta.md CHANGED
@@ -1,57 +1,69 @@
1
1
  # Install — internal beta
2
2
 
3
- Audience: Patze team and trusted beta testers. Package: `@patze/code-cli@0.10.x`.
3
+ For Patze team and trusted testers. Current line: **`@patze/code-cli@0.55.x`** (`@beta` on npm).
4
+
5
+ Overview: [README](../README.md) · Limits: [`known-limitations.md`](known-limitations.md)
4
6
 
5
7
  ## Prerequisites
6
8
 
7
- - **Node.js 20+**
8
- - Optional: PatzeAgents API credentials via env (never commit secrets)
9
+ - Node.js **20+**
10
+ - A git workspace (recommended for apply tests)
11
+ - Patze API access for agent tasks (optional for read-only smoke)
9
12
 
10
- ## Option A — npm registry (when published)
13
+ ## Install from npm
11
14
 
12
15
  ```bash
13
16
  npm install -g @patze/code-cli@beta
14
- # or pinned:
15
- npm install -g @patze/code-cli@0.10.2
17
+ patze --version
18
+ ```
19
+
20
+ Pinned example:
21
+
22
+ ```bash
23
+ npm install -g @patze/code-cli@0.55.2
16
24
  ```
17
25
 
18
- ## Option B — local tarball (maintainers / monorepo)
26
+ Use `@beta`, not `latest` — `latest` is an older stable tag until 1.0.
27
+
28
+ ## Install from monorepo (maintainers)
19
29
 
20
30
  ```bash
21
31
  cd packages/patze-code-cli
22
32
  ./scripts/install-beta.sh local
23
33
  ```
24
34
 
25
- Manual equivalent:
35
+ Manual:
26
36
 
27
37
  ```bash
28
38
  cd packages/patze-code-cli
29
- npm run build
30
- npm pack
31
- npm install -g ./patze-code-cli-0.10.2.tgz
39
+ npm run build && npm pack
40
+ npm install -g ./patze-code-cli-0.55.2.tgz
32
41
  ```
33
42
 
34
- ## Option C — development link
43
+ Dev link:
35
44
 
36
45
  ```bash
37
46
  cd packages/patze-code-cli
38
- npm run build
39
- npm link
47
+ npm run build && npm link
40
48
  ```
41
49
 
42
- ## Verify install
50
+ ## Sign in
51
+
52
+ Recommended (dashboard device code):
43
53
 
44
54
  ```bash
45
- patze --version # expect @patze/code-cli 0.10.x
46
- patze status # auth may be incomplete (exit 1) — OK for first run
47
- patze doctor # read-only diagnostics, no network
48
- patze doctor --check # optional /health probe (needs auth + api)
49
- patze # interactive shell — trust loop entry
55
+ patze login --pair --api https://api.example.com
50
56
  ```
51
57
 
52
- ## Optional auth (server preview)
58
+ Inside `patze`: `/login`
53
59
 
54
- Use env vars — do not paste tokens into issue reports:
60
+ Manual:
61
+
62
+ ```bash
63
+ patze login <api-url> <token> [user-uuid]
64
+ ```
65
+
66
+ Env (never paste into issues):
55
67
 
56
68
  ```bash
57
69
  export PATZE_CODE_API=https://api.example.com
@@ -60,18 +72,25 @@ export PATZE_CODE_USER_ID=<user-uuid>
60
72
  patze status --check
61
73
  ```
62
74
 
63
- Or one-time local config:
75
+ Optional — live models in `/model`: `CURSOR_API_KEY`
76
+
77
+ ## Verify install
64
78
 
65
79
  ```bash
66
- patze login <api-url> <token> <user-uuid>
80
+ patze --version # expect 0.55.x
81
+ patze doctor # read-only; no network required
82
+ patze status # exit 1 without auth is OK on first run
83
+ patze # interactive shell
67
84
  ```
68
85
 
69
- ## Uninstall / reset
86
+ First launch shows a **compact header** (model + directory) and an **empty composer** (`>` only). Auth hints appear in the header/transcript, not inside the input box.
87
+
88
+ ## Uninstall
70
89
 
71
- See [`uninstall-reset.md`](uninstall-reset.md).
90
+ [`uninstall-reset.md`](uninstall-reset.md)
72
91
 
73
- ## Related
92
+ ## Next steps
74
93
 
75
- - [`beta-tester-checklist.md`](beta-tester-checklist.md)
76
- - [`internal-beta.md`](internal-beta.md)
77
- - [`known-limitations.md`](known-limitations.md)
94
+ - Tester checklist: [`beta-tester-checklist.md`](beta-tester-checklist.md)
95
+ - Feedback template: [`beta-feedback-template.md`](beta-feedback-template.md)
96
+ - Maintainer publish: [`beta-release-handoff.md`](beta-release-handoff.md)
package/docs/known-limitations.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # Known limitations — Patze Code CLI (0.55.x)
2
2
 
3
3
  These are **intentional** for the current slice unless behavior contradicts this list.
4
- Last aligned with **`npm run verify`** (unit + smoke + PTY suite) at **0.55.0**.
4
+ Last aligned with **`npm run verify`** at **0.55.2** (README + install docs).
5
5
 
6
6
  ## Authentication
7
7
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@patze/code-cli",
3
- "version": "0.55.1",
3
+ "version": "0.55.2",
4
4
  "description": "Patze Code — local terminal coding agent client for PatzeAgents",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",