@tonbo/cli 0.0.6 → 0.0.7

package/README.md

@@ -7,16 +7,21 @@ npm install --global @tonbo/cli
 tonbo --version
 ```
 
-The V1 CLI deploys a PI-based Agent directly from a local directory without requiring Git or Tonbo calls in the Agent source. Initialize the current directory interactively:
+The CLI deploys an Agent directly from a local directory without requiring Git or Tonbo calls in the Agent source. Initialize the current directory interactively:
 
 ```console
 tonbo init
-? Agent shape: [1] PI project  [2] PI Package project  [3] PI SDK app [1]:
-? Inference model [claude-sonnet-4-5]:
+? How should Tonbo run this project?
+❯ PI CLI (`pi`)  Run pi directly with AGENTS.md and optional project-local .pi resources.
+  PI SDK app     Run a custom Node.js entrypoint built on the PI SDK.
 Created .tonbo.
+Harness: PI
+Mode: PI CLI
 Next: tonbo project create <slug>
 ```
 
+Use the arrow keys to select an available execution target and Enter to confirm. `AGENTS.md` is Harness-neutral and never identifies PI by itself. When `.pi/settings.json` exists, the shared source inspector identifies the PI Harness, reports its project-local packages, and narrows the prompt to the native PI or PI SDK execution modes. Unsupported and planned Harnesses are not shown.
+
 The generated `.tonbo` is TOML:
 
 ```toml
@@ -32,7 +37,14 @@ kind = "native"
 model = "claude-sonnet-4-5"
 ```
 
-For automation, use `tonbo init --model <model>`; an existing declaration requires interactive confirmation or `--force`. Then authenticate, bind the directory and deploy its current contents:
+The default inference model is written without prompting. Override it explicitly with `--model`. Automation must make ambiguous choices explicit; an existing declaration requires interactive confirmation or `--force`:
+
+```console
+tonbo init --harness pi --driver native
+tonbo init --harness pi --driver command --agent-entry dist/agent.mjs
+```
+
+Then authenticate, bind the directory and deploy its current contents:
 
 ```console
 tonbo login
@@ -83,7 +95,7 @@ tonbo run "Start the task."
 
 ### 2. PI Package project
 
-Use PI's project-local package declaration as the single source of truth. Install an immutable package reference locally, verify it with PI, and deploy the project; Tonbo excludes `.pi/npm` and `.pi/git` caches and restores packages inside the isolated runtime:
+Use PI's project-local package declaration as the single source of truth. A package is a PI resource, not another Tonbo execution mode: `tonbo init` recognizes `.pi/settings.json`, then the native PI driver loads the packages. Install an immutable package reference locally, verify it with PI, and deploy the project; Tonbo excludes `.pi/npm` and `.pi/git` caches and restores packages inside the isolated runtime:
 
 ```console
 pi install -l npm:@acme/my-pi-agent@1.2.3
@@ -96,7 +108,7 @@ Remote npm packages must use an exact version. Git packages must use a full 40-c
 
 ### 3. PI SDK app
 
-Choose `PI SDK app` in `tonbo init`, or declare a command driver directly:
+Choose `PI SDK app` with the arrow selector, use `--driver command --agent-entry <file>` in automation, or declare a command driver directly:
 
 ```toml
 version = 1
@@ -131,6 +143,8 @@ Node.js 22 or newer is required. Human OAuth tokens are stored at `${XDG_CONFIG_
 ## Related design
 
 - [Design documentation map](../../docs/design/README.md)
+- [Agent source inspection and onboarding](../../docs/design/agent-source-onboarding.md)
+- [Shared source inspector](../../packages/agent-source-inspector/README.md)
 - [Project resource model](../../docs/design/project-resource-model.md)
 - [ADR-0008: Tonbo CLI onboarding and credential boundaries](../../apps/user-center/docs/decisions/adr-0008-tonbo-cli-onboarding.md)
 - [Management API v1](../../contracts/management/openapi-v1.yaml)