t3code-cli 0.8.0 → 0.9.0

package/README.md

@@ -1,72 +1,109 @@
 # t3code-cli
 
-Non-interactive CLI for a t3code server.
+Non-interactive CLI for [t3code](https://t3code.dev) — manage projects, models, and agent threads from the terminal.
 
-## install
+## Installation
 
 ```sh
 npm install --global t3code-cli
 ```
 
-This installs the `t3cli` command.
+This installs the `t3cli` command globally.
 
-## agent skill
+## Quick Start
+
+```sh
+# Authenticate
+t3cli auth pair --url <pairing-url> [--local]
+
+# Or use local auth
+t3cli auth local
+
+# Check status
+t3cli auth status
+
+# List projects
+t3cli project list
+
+# Start a thread
+t3cli thread start "Implement a new feature" --wait
+```
+
+## Agent Skill
 
 This repo includes an agent skill for operating `t3cli`: [`skills/t3code-cli/SKILL.md`](skills/t3code-cli/SKILL.md).
 
-Install it with [skills](https://skills.sh/):
+Install it with:
 
 ```sh
 npx skills add tarik02/t3cli
 ```
 
-## authenticate
+## Authentication
 
 ```sh
-t3cli auth pair --url <url> [--local]
-t3cli auth local [--base-dir <path>] [--origin <url>] [--role owner|client] [--label <label>] [--subject <subject>]
-t3cli auth status
+t3cli auth pair --url <url> [--local]     # Pair with a remote server
+t3cli auth local                          # Local t3code installation
+t3cli auth status                         # Check current auth
 ```
 
-Use `auth pair` with a pairing URL from a running t3code server, or `auth local` to authenticate against a local t3code installation. Local auth (`auth local` or `auth pair --local`) enables automatic project resolution from the current directory.
+- Use `auth pair` with a pairing URL from a running t3code server
+- Use `auth local` to authenticate against a local t3code installation
+- Local auth enables automatic project resolution from the current directory
 
-## project
+## Project Management
 
 ```sh
-t3cli project list
+t3cli project list                        # List known projects
 t3cli project add [--path <path>] [--title <title>]
 ```
 
-`project list` shows known projects. `project add` registers a project path with the server. `--path` defaults to the current directory.
+The `--path` defaults to the current directory.
 
-## model
+## Models
 
 ```sh
 t3cli model list [--all] [--provider <provider>]
 ```
 
-Lists available provider models. Use `--all` to include hidden or unavailable entries when the server exposes them.
+Lists available provider models. Use `--all` to include hidden or unavailable entries.
 
-## thread
+## Thread Management
+
+### Starting Threads
 
 ```sh
-t3cli thread list [--project <ref>]
-t3cli thread start [message] [--project <ref>] [--stdin] [--title <title>] [--worktree <path>] [--provider <provider>] [--model <model>] [--option <key=value>] [--reasoning-effort <value>] [--effort <value>] [--fast-mode] [--thinking] [--wait]
-t3cli thread send [--thread <id>] [message] [--stdin] [--option <key=value>] [--reasoning-effort <value>] [--effort <value>] [--fast-mode] [--thinking] [--wait]
-t3cli thread messages [--thread <id>] [--limit <count>] [--full]
-t3cli thread wait [--thread <id>]
-t3cli thread archive [--thread <id>]
+t3cli thread start [message]
+  [--project <ref>]
+  [--stdin]
+  [--title <title>]
+  [--worktree <path>]
+  [--provider <provider>]
+  [--model <model>]
+  [--option <key=value>]
+  [--reasoning-effort <value>]
+  [--effort <value>]
+  [--fast-mode]
+  [--thinking]
+  [--wait]
 ```
 
-`--project` accepts a project id or path. When omitted, the CLI resolves the project from the current directory only for local auth (`auth local` or `auth pair --local`). Resolution checks a registered `workspaceRoot`, paths under it, and known thread `worktreePath` values from the server snapshot. Remote pairings require an explicit `--project` or `T3CODE_PROJECT_*` env var. `thread start` infers the worktree from cwd unless `--worktree` or `T3CODE_WORKTREE_PATH` is set.
-
-Thread-targeting commands accept `--thread` or fall back to `T3CODE_THREAD_ID`.
+### Thread Commands
 
-Use `--stdin` when the message should be read from standard input instead of an argument. Use `--wait` to stream until the thread pauses.
+```sh
+t3cli thread list [--project <ref>]              # List threads
+t3cli thread show [--thread <id>]                # Show thread details
+t3cli thread send [--thread <id>] [message]      # Send message to thread
+t3cli thread messages [--thread <id>] [--limit]  # View messages
+t3cli thread wait [--thread <id>]                # Wait for completion
+t3cli thread archive [--thread <id>]             # Archive thread
+t3cli thread approve --request <id>              # Approve request
+t3cli thread respond --request <id>              # Respond to request
+```
 
-## environment fallbacks
+### Environment Variables
 
-When flags are omitted, the CLI reads these variables (first match wins within each group):
+When flags are omitted, the CLI reads these environment variables (first match wins):
 
 | Variable               | Used by                                   |
 | ---------------------- | ----------------------------------------- |
@@ -75,7 +112,14 @@ When flags are omitted, the CLI reads these variables (first match wins within e
 | `T3CODE_WORKTREE_PATH` | `--worktree`                              |
 | `T3CODE_THREAD_ID`     | `--thread`                                |
 
-## output
+### Project Resolution
+
+- `--project` accepts a project id or path
+- When omitted, the CLI resolves the project from the current directory (local auth only)
+- Resolution checks: registered `workspaceRoot` → paths under it → known thread `worktreePath`
+- Remote pairings require explicit `--project` or `T3CODE_PROJECT_*` env var
+
+## Output Formats
 
 Most commands support:
 
@@ -83,13 +127,24 @@ Most commands support:
 --format auto|human|json
 ```
 
-Thread start/send commands also support `--format ndjson`; `thread wait` supports `--format human|ndjson`.
+Thread commands also support `ndjson` for streaming:
 
-Global flags:
+```sh
+t3cli thread start "task" --format ndjson --wait
+t3cli thread wait --format ndjson
+```
+
+## Global Flags
 
 ```sh
---help
---version
---completions bash|zsh|fish|sh
---log-level all|trace|debug|info|warn|warning|error|fatal|none
+--help                    # Show help
+--version                 # Show version
+--completions <shell>     # Generate shell completions (bash|zsh|fish|sh)
+--log-level <level>        # Set log level
 ```
+
+## Links
+
+- [Agent Skill Documentation](skills/t3code-cli/SKILL.md)
+- [Command Reference](skills/t3code-cli/reference/commands.md)
+- [Setup Guide](skills/t3code-cli/reference/setup.md)

package/dist/application.js

@@ -1,2 +1,2 @@
-import { t as T3Application } from "./service-ybOWV9pL.js";
+import { Nd as T3Application } from "./shared.js";
 export { T3Application };

package/dist/auth.js

@@ -1,3 +1,2 @@
-import { a as makeT3AuthPairing, b as makeT3LocalAuthOrigin, c as T3LocalAuthLive, d as T3LocalAuthTokenLive, f as makeT3LocalAuthToken, i as T3AuthPairingLive, l as makeT3LocalAuth, n as makeT3Auth, o as parsePairingUrl, r as T3AuthPairing, s as T3LocalAuth, t as T3AuthLive, u as T3LocalAuthToken, v as T3LocalAuthOrigin, x as T3Auth, y as T3LocalAuthOriginLive } from "./layer-Do8wK1t6.js";
-import { a as AuthLocalSigningError, i as AuthLocalSecretError, n as AuthLocalDatabaseError, o as AuthPairingUrlError, r as AuthLocalError, s as AuthTransportError, t as AuthConfigError } from "./error-CjADNVm8.js";
+import { A as T3LocalAuthOriginLive, B as AuthLocalSigningError, C as T3LocalAuth, D as T3LocalAuthTokenLive, E as T3LocalAuthToken, H as AuthTransportError, I as AuthConfigError, Kd as T3Auth, L as AuthLocalDatabaseError, O as makeT3LocalAuthToken, R as AuthLocalError, T as makeT3LocalAuth, V as AuthPairingUrlError, _ as makeT3Auth, b as makeT3AuthPairing, g as T3AuthLive, j as makeT3LocalAuthOrigin, k as T3LocalAuthOrigin, v as T3AuthPairing, w as T3LocalAuthLive, x as parsePairingUrl, y as T3AuthPairingLive, z as AuthLocalSecretError } from "./shared.js";
 export { AuthConfigError, AuthLocalDatabaseError, AuthLocalError, AuthLocalSecretError, AuthLocalSigningError, AuthPairingUrlError, AuthTransportError, T3Auth, T3AuthLive, T3AuthPairing, T3AuthPairingLive, T3LocalAuth, T3LocalAuthLive, T3LocalAuthOrigin, T3LocalAuthOriginLive, T3LocalAuthToken, T3LocalAuthTokenLive, makeT3Auth, makeT3AuthPairing, makeT3LocalAuth, makeT3LocalAuthOrigin, makeT3LocalAuthToken, parsePairingUrl };