@amistio/cli 0.1.6 → 0.1.8

package/README.md

@@ -10,3 +10,33 @@ amistio --help
 ```
 
 The package install only installs the `amistio` command. Repository cloning, project pairing, credential storage, and runner execution happen only when the user explicitly runs commands such as `amistio bootstrap`, `amistio pair`, or `amistio run --watch`.
+
+Runner lifecycle controls in the web app, such as update, restart, and remove, apply only to the runner paired by that user unless the active organization role is an admin role. The runner API binds command polling, command status, logs, activity, and tool sessions to the local runner credential that produced them.
+
+After pairing, confirm that at least one local AI tool is available:
+
+```sh
+amistio tools
+```
+
+If no supported tool is available, install and authenticate one of the supported local tools, such as opencode, then start the runner:
+
+```sh
+amistio run --watch --tool opencode
+amistio run --watch --background --tool opencode
+amistio runner status
+```
+
+When `--tool copilot` uses the GitHub Copilot SDK, Amistio approves read-only permission requests by default and denies mutating, network, MCP, hook, memory, and shell requests. Set `AMISTIO_COPILOT_APPROVE_ALL=1` only on a local machine where broad Copilot SDK approval is intentional.
+
+`amistio runner status` reports local background runner state, latest heartbeat, and bounded resource usage when available. Resource usage is latest-sample runner process memory/CPU plus safe aggregate system memory/load signals; it does not include source files, environment variables, command lines, process lists, credentials, or arbitrary local paths.
+
+Runner setup and local-tool execution use bounded failure controls. `amistio run --watch` retries Git worktree preflight failures by releasing the claim for another attempt, then fails the work item after `--max-preflight-attempts` attempts, defaulting to 3. Active local-tool runs renew the work lease, and `--tool-timeout-seconds` caps tool execution, defaulting to 1800 seconds.
+
+For headless startup after login on supported user-level service managers:
+
+```sh
+amistio runner service install --tool opencode
+amistio runner service status
+amistio runner service remove
+```