phonton-cli 0.4.8 → 0.6.0
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.
- package/README.md +45 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
<img src="assets/readme/phonton-cli-logo.png" width="112" alt="Phonton CLI logo">
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
<h1 align="center">Phonton CLI · v0.
|
|
5
|
+
<h1 align="center">Phonton CLI · v0.6.0</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<strong>Verified code changes with repo memory.</strong><br>
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
<p align="center">
|
|
13
13
|
<a href="https://github.com/phonton-dev/phonton-cli/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/phonton-dev/phonton-cli/actions/workflows/ci.yml/badge.svg"></a>
|
|
14
14
|
<a href="https://github.com/phonton-dev/phonton-cli/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/phonton-dev/phonton-cli?style=flat&label=stars"></a>
|
|
15
|
-
<img alt="release" src="https://img.shields.io/badge/release-v0.
|
|
15
|
+
<img alt="release" src="https://img.shields.io/badge/release-v0.6.0-6c63ff">
|
|
16
16
|
<img alt="license" src="https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue">
|
|
17
17
|
<img alt="status" src="https://img.shields.io/badge/status-public_alpha-f97316">
|
|
18
18
|
</p>
|
|
@@ -49,10 +49,30 @@ That gives Phonton a different shape from an IDE assistant or a chat-first termi
|
|
|
49
49
|
- **BYOK:** use your own provider account instead of routing every task through a Phonton-hosted model bill.
|
|
50
50
|
- **Measured claims:** token and cost efficiency should be benchmarked per task, not guessed.
|
|
51
51
|
|
|
52
|
+
## Trust Demo Loop
|
|
53
|
+
|
|
54
|
+
The product promise is intentionally narrow:
|
|
55
|
+
|
|
56
|
+
```text
|
|
57
|
+
goal -> contract -> edit -> verify -> receipt -> remember
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Try the proof-oriented demo text before configuring a provider:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
phonton demo trust-loop
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
It walks through the evidence trail a real run should expose: GoalContract, plan preview, verification failure and retry, review receipt, known gaps, rollback point, and memory prompt.
|
|
67
|
+
|
|
52
68
|
## What Works Today
|
|
53
69
|
|
|
54
70
|
- Interactive Ratatui TUI with goal, task, ask, settings, git, and flight-log surfaces.
|
|
71
|
+
- Unified slash commands in the TUI: `/settings`, `/config`, `/status`, `/review`, `/memory`, `/permissions`, `/model`, `/commands`, `/run`, and `!` all route through the same command registry and prompt drawer.
|
|
55
72
|
- Saved workspace sessions: use `phonton -r` or `phonton --resume` to reopen the last saved TUI conversation for the current repo.
|
|
73
|
+
- Prompt bar paste artifacts: long or multiline pasted text collapses into a compact chip while the full content stays attached to the submitted goal.
|
|
74
|
+
- Windows clipboard import in the TUI with `Ctrl+V`, including content selected from Windows clipboard history (`Win+V`) when the terminal does not emit bracketed paste directly.
|
|
75
|
+
- Sandboxed command runs from the prompt bar with `/run <cmd>` or `!<cmd>`, plus command status and output previews in the TUI and Flight Log.
|
|
56
76
|
- `phonton doctor` setup diagnostics for config, provider key, store, trust, git, cargo, and Nexus config.
|
|
57
77
|
- `phonton plan` preview for task DAGs before edits happen.
|
|
58
78
|
- `phonton review` surfaces for verified diff review payloads, approvals, rejections, and rollback.
|
|
@@ -63,6 +83,8 @@ That gives Phonton a different shape from an IDE assistant or a chat-first termi
|
|
|
63
83
|
- `phonton mcp` commands for listing configured servers and lazily approving tool discovery or tool calls.
|
|
64
84
|
- BYOK provider adapters for Anthropic, OpenAI, OpenRouter, Gemini, Cloudflare Workers AI, AgentRouter, DeepSeek, xAI/Grok, Groq, Together, Ollama, and custom OpenAI-compatible endpoints. `phonton doctor --provider` verifies your configured provider by checking model discovery and a tiny completion call through the same adapter used for runs.
|
|
65
85
|
- Local store, memory, planner, worker, diff, sandbox, verification, and orchestration crates.
|
|
86
|
+
- Prompt-section token manifests in the Flight Log so system, goal, memory, attachment, MCP, and retry-context costs are inspectable.
|
|
87
|
+
- `phonton demo trust-loop` prints a compact proof-oriented walkthrough of the GoalContract -> verification -> receipt -> memory loop for first-run demos.
|
|
66
88
|
- Semantic indexing behind the CLI stack for repo-aware workflows.
|
|
67
89
|
|
|
68
90
|
## What Is Still Early
|
|
@@ -103,7 +125,7 @@ Windows PowerShell:
|
|
|
103
125
|
Direct Cargo install:
|
|
104
126
|
|
|
105
127
|
```bash
|
|
106
|
-
cargo install --git https://github.com/phonton-dev/phonton-cli --tag v0.
|
|
128
|
+
cargo install --git https://github.com/phonton-dev/phonton-cli --tag v0.6.0 phonton-cli --locked --force
|
|
107
129
|
```
|
|
108
130
|
|
|
109
131
|
Check the install:
|
|
@@ -119,7 +141,7 @@ Phonton uses GitHub branches and releases as install channels:
|
|
|
119
141
|
|
|
120
142
|
| Channel | Install | Use when |
|
|
121
143
|
|---|---|---|
|
|
122
|
-
| Stable | `cargo install --git https://github.com/phonton-dev/phonton-cli --tag v0.
|
|
144
|
+
| Stable | `cargo install --git https://github.com/phonton-dev/phonton-cli --tag v0.6.0 phonton-cli --locked --force` | You want the best validated public alpha |
|
|
123
145
|
| Dev | `cargo install --git https://github.com/phonton-dev/phonton-cli --branch dev phonton-cli --locked --force` | You want next-release integration changes |
|
|
124
146
|
| Nightly | `cargo install --git https://github.com/phonton-dev/phonton-cli --branch nightly phonton-cli --locked --force` | You want daily snapshots and can tolerate breakage |
|
|
125
147
|
| Main | `cargo install --git https://github.com/phonton-dev/phonton-cli --branch main phonton-cli --locked --force` | You want the current release branch tip |
|
|
@@ -201,7 +223,9 @@ phonton doctor --provider
|
|
|
201
223
|
```text
|
|
202
224
|
phonton Launch the interactive TUI
|
|
203
225
|
phonton -r Resume the saved TUI session for this workspace
|
|
226
|
+
phonton init Create ~/.phonton/config.toml if it is missing
|
|
204
227
|
phonton ask <question> One-shot Q&A using the configured provider
|
|
228
|
+
phonton demo trust-loop Print the evidence-trail demo loop
|
|
205
229
|
phonton doctor Check config, store, trust, git, cargo, and Nexus
|
|
206
230
|
phonton plan <goal> Preview the task DAG without changing files
|
|
207
231
|
phonton review Show verified diff review payloads
|
|
@@ -213,6 +237,23 @@ phonton config show Dump resolved config as TOML
|
|
|
213
237
|
phonton version Print version
|
|
214
238
|
```
|
|
215
239
|
|
|
240
|
+
Inside the TUI prompt bar:
|
|
241
|
+
|
|
242
|
+
```text
|
|
243
|
+
/settings, /config Open provider/model/budget settings
|
|
244
|
+
/status Show version, provider, model, workspace, and token state
|
|
245
|
+
/review Show review receipt guidance for the selected goal
|
|
246
|
+
/memory Inspect local decision memory
|
|
247
|
+
/permissions Show sandbox, trust, and approval status
|
|
248
|
+
/model set <name> Save a model preference
|
|
249
|
+
/commands Show slash-command and keyboard help
|
|
250
|
+
/run <cmd> Run a sandboxed command
|
|
251
|
+
!<cmd> Shorthand for a sandboxed command
|
|
252
|
+
Ctrl+V Paste from the Windows clipboard
|
|
253
|
+
Ctrl+U / Ctrl+K Clear before / after cursor
|
|
254
|
+
Tab Complete slash commands
|
|
255
|
+
```
|
|
256
|
+
|
|
216
257
|
Plan preview:
|
|
217
258
|
|
|
218
259
|
```bash
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "phonton-cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "Local-first agentic development terminal with context packs, source handles, and verification gates.",
|
|
5
5
|
"license": "MIT OR Apache-2.0",
|
|
6
6
|
"homepage": "https://github.com/phonton-dev/phonton-cli#readme",
|