t3code-cli 0.10.0 → 0.12.0

package/README.md

@@ -41,21 +41,34 @@ npx skills add tarik02/t3cli
 
 ## Authentication
 
+`t3cli` stores multiple named auth environments in `~/.config/t3cli/config.json` (or `$XDG_CONFIG_HOME/t3cli/config.json`). Tokens are encrypted at rest with AES-256-GCM; the master key is stored in the OS keyring when available, otherwise in `~/.config/t3cli/key`.
+
 ```sh
-t3cli auth pair --url <url> [--local]     # Pair with a remote server
-t3cli auth local                          # Local t3code installation
-t3cli auth status                         # Check current auth
+t3cli auth pair --url <url> [--name <name>] [--replace] [--local]   # Pair with a remote server
+t3cli auth local [--name <name>] [--replace]                        # Local t3code installation
+t3cli auth status [--format json]                                   # Check current auth
+t3cli env list [--format json]                                      # List stored environments
+t3cli env use <name> [--format json]                                # Set default environment
+t3cli env remove [--name <name>] [--yes]                            # Remove local credentials
+t3cli --environment <name> ...                                      # Use a specific environment once
 ```
 
 - Use `auth pair` with a pairing URL from a running t3code server
-- Use `auth local` to authenticate against a local t3code installation
+- Default environment names: hostname slug from the paired URL, or `local` for `auth local`
+- `auth pair` / `auth local` set the default environment only when creating the first stored environment; use `env use` to switch afterward
+- `--replace` overwrites an existing environment and makes it the default
+- `env remove` removes local CLI credentials only; any remote token can remain valid until natural expiry
+- Use `auth local` or `auth pair --local` to authenticate against a local t3code installation
 - Local auth enables automatic project resolution from the current directory
+- Set `T3CLI_ENV=<name>` to select an environment when `--environment` is omitted
+- `T3CODE_URL` and `T3CODE_TOKEN` override the selected environment only when both are set
 
 ## Project Management
 
 ```sh
 t3cli project list                        # List known projects
 t3cli project add [--path <path>] [--title <title>]
+t3cli project delete [--project <ref>] [--force] [--yes]
 ```
 
 The `--path` defaults to the current directory.
@@ -91,7 +104,7 @@ t3cli start [message]
 ### Common Thread Commands
 
 ```sh
-t3cli list [--project <ref>]                 # List threads
+t3cli list [--project <ref>] [--archived | --all]
 t3cli show [--thread <id>]                   # Show thread details
 t3cli send [--thread <id>] [message]         # Send message to thread
 t3cli transcript [--thread <id>] [--limit]   # View messages
@@ -103,20 +116,70 @@ t3cli wait [--thread <id>]                   # Wait for completion
 ```sh
 t3cli thread archive [--thread <id>]        # Archive thread
 t3cli thread approve --request <id>         # Approve request
+t3cli thread interrupt [--thread <id>]      # Interrupt running turn
 t3cli thread respond --request <id>         # Respond to request
+t3cli thread update [--thread <id>]         # Update thread metadata
+t3cli thread unarchive [--thread <id>]      # Unarchive thread
+t3cli thread delete [--thread <id>] [--yes] # Delete thread
 t3cli thread callback --from <id>           # Notify another thread on completion
 ```
 
+## Action Commands
+
+Project-defined toolbar actions are exposed as `t3cli action`.
+
+```sh
+t3cli action list [--project <ref>] [--format auto|human|json]
+t3cli action run --thread <id> (--id <id> | --name <name>) [--terminal <id>] [--attach] [--format auto|human|json]
+t3cli action add [--project <ref>] --name <name> --command <command> [--id <id>] [--icon play|test|lint|configure|build|debug] [--setup] [--preview-url <url>] [--auto-open-preview] [--format auto|human|json]
+t3cli action update [--project <ref>] (--id <id> | --name <name>) [--set-name <name>] [--command <command>] [--icon play|test|lint|configure|build|debug] [--setup | --no-setup] [--preview-url <url> | --clear-preview-url] [--auto-open-preview | --no-auto-open-preview | --clear-auto-open-preview] [--format auto|human|json]
+t3cli action delete [--project <ref>] (--id <id> | --name <name>) [--yes] [--format auto|human|json]
+```
+
+`action list`, `add`, `update`, and `delete` use normal project resolution: `--project`, `T3CODE_PROJECT_ROOT`, `T3CODE_PROJECT_ID`, or cwd with local auth. `action run` infers the project from `--thread`.
+
+Selectors require exactly one of `--id` or `--name`. Name matching is exact after trimming and case folding, and must match a single action. `action add` generates an id from `--name` when omitted. `--setup` marks the action to run on worktree creation and clears setup from other actions. Preview fields are stored on the action; `action run` only starts the terminal command and does not open previews.
+
+## Terminal Commands
+
+```sh
+t3cli terminal list [--thread <id>] [--format auto|human|json]
+t3cli terminal create [--thread <id>] [command] [--id <id>] [--attach] [--format auto|human|json]
+t3cli terminal attach [--thread <id>] <terminal-id>
+t3cli terminal read [--thread <id>] <terminal-id> [--history] [--format json|ndjson]
+t3cli terminal read [--thread <id>] <terminal-id> --history --follow --format ndjson [--from-sequence <n>]
+t3cli terminal stream [--thread <id>] <terminal-id> [--format ndjson] [--from-sequence <n>]
+t3cli terminal wait [--thread <id>] <terminal-id> [--for exited|closed|ended] [--format auto|human|json]
+t3cli terminal write [--thread <id>] <terminal-id> <data> [--format auto|human|json] [--quiet]
+t3cli terminal write [--thread <id>] <terminal-id> --stdin [--format auto|human|json] [--quiet]
+t3cli terminal write [--thread <id>] <terminal-id> --hex <hex> [--format auto|human|json] [--quiet]
+t3cli terminal write [--thread <id>] <terminal-id> --base64 <base64> [--format auto|human|json] [--quiet]
+t3cli terminal destroy [--thread <id>] <terminal-id> [--yes] [--format auto|human|json] [--quiet]
+```
+
+`terminal list` shows a one-shot snapshot of terminals for a thread. `terminal create` opens a server-owned terminal in the thread workspace, using the active thread worktree when present and the project workspace root otherwise. When `[command]` is provided, the CLI opens the terminal first and then writes `${command}\r`.
+
+`terminal attach` replays terminal history and then streams live output while forwarding local input to the remote PTY. Use `Ctrl-]` to detach locally without destroying the remote terminal. `Ctrl-C` is forwarded to the remote terminal. Terminal resize events are forwarded to the server.
+
+`terminal read` returns the current terminal snapshot. Add `--history` to include snapshot history. Add `--follow --format ndjson` to continue streaming structured events after the snapshot. `--from-sequence` is inclusive: events with sequence greater than or equal to `<n>` are emitted after the initial snapshot. `terminal stream` is the lower-level attach event stream for agents and always emits ndjson attach events.
+
+`terminal wait` blocks until the terminal emits the requested lifecycle event. `exited` waits for the process to end, `closed` waits for the server-owned terminal session to be removed, and `ended` accepts either.
+
+`terminal write` accepts exactly one payload source: raw argument text, `--stdin`, `--hex`, or `--base64`. Payloads are treated as raw bytes (latin1), not UTF-8 text. `terminal destroy` performs a destructive close with history deletion and requires `--yes` in non-interactive mode.
+
 ### Environment Variables
 
 When flags are omitted, the CLI reads these environment variables (first match wins):
 
-| Variable               | Used by                                   |
-| ---------------------- | ----------------------------------------- |
-| `T3CODE_PROJECT_ROOT`  | `--project`                               |
-| `T3CODE_PROJECT_ID`    | `--project` (after `T3CODE_PROJECT_ROOT`) |
-| `T3CODE_WORKTREE_PATH` | `--worktree`                              |
-| `T3CODE_THREAD_ID`     | `--thread`                                |
+| Variable               | Used by                                       |
+| ---------------------- | --------------------------------------------- |
+| `T3CODE_PROJECT_ROOT`  | `--project`                                   |
+| `T3CODE_PROJECT_ID`    | `--project` (after `T3CODE_PROJECT_ROOT`)     |
+| `T3CODE_WORKTREE_PATH` | `--worktree`                                  |
+| `T3CODE_THREAD_ID`     | `--thread`                                    |
+| `T3CLI_ENV`            | `--environment`                               |
+| `T3CODE_URL`           | server URL override (requires `T3CODE_TOKEN`) |
+| `T3CODE_TOKEN`         | auth token override (requires `T3CODE_URL`)   |
 
 ### Project Resolution
 
@@ -145,6 +208,7 @@ t3cli wait --format ndjson
 ```sh
 --help                    # Show help
 --version                 # Show version
+--environment <name>      # Auth environment for this command
 --completions <shell>     # Generate shell completions (bash|zsh|fish|sh)
 --log-level <level>        # Set log level
 ```

package/dist/application.js

@@ -1,2 +1,2 @@
-import { Nd as T3Application } from "./shared.js";
-export { T3Application };
+import { B as T3ModelApplicationLive, Gm as T3ActionApplication, H as T3TerminalApplicationLive, Jm as T3ProjectApplication, Km as T3Application, L as T3ActionApplicationLive, R as T3ApplicationLive, U as T3ThreadApplicationLive, V as T3ProjectApplicationLive, W as makeT3Application, Xm as T3ThreadApplication, Ym as T3TerminalApplication, qm as T3ModelApplication, z as T3ApplicationSlicesLive } from "./shared.js";
+export { T3ActionApplication, T3ActionApplicationLive, T3Application, T3ApplicationLive, T3ApplicationSlicesLive, T3ModelApplication, T3ModelApplicationLive, T3ProjectApplication, T3ProjectApplicationLive, T3TerminalApplication, T3TerminalApplicationLive, T3ThreadApplication, T3ThreadApplicationLive, makeT3Application };

package/dist/auth.js

@@ -1,2 +1,2 @@
-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";
+import { $ as AuthLocalError, A as T3LocalAuthToken, C as T3AuthPairing, D as T3LocalAuth, E as parsePairingUrl, F as makeT3LocalAuthOrigin, Gp as T3Auth, M as makeT3LocalAuthToken, N as T3LocalAuthOrigin, O as T3LocalAuthLive, P as T3LocalAuthOriginLive, Q as AuthLocalDatabaseError, S as makeT3Auth, T as makeT3AuthPairing, Z as AuthConfigError, et as AuthLocalSecretError, j as T3LocalAuthTokenLive, k as makeT3LocalAuth, nt as AuthPairingUrlError, rt as AuthTransportError, tt as AuthLocalSigningError, w as T3AuthPairingLive, x as T3AuthLive } 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 };