@agora-build/atem 0.6.12 → 0.6.15

package/README.md

@@ -36,7 +36,7 @@ atem login                              # Log in with Agora Console (opens brows
 atem logout                             # Log out from SSO
 atem pair                               # Pair with Astation, then verify this device
 atem pair --save                        # Same, and keep credentials for offline use
-atem unpair                             # Remove all Astation pairings
+atem unpair [--yes]                     # Remove all Astation pairings (asks first)
 ```
 
 `atem login` unlocks a limited set: project list, tokens for the active
@@ -49,7 +49,10 @@ tasks and diagrams. `serv files`, `config`, and tokens from
 `atem pair` receives your Agora login from Astation, then verifies the device:
 atem and your Mac each show a 12-character safety code. If they match, type
 `y` here; on the Mac click **Codes Match**, then approve with Touch ID.
-Either side can finish first. A connected or SSO-paired session alone does not
+Either side can finish first. atem reads that `y` from the terminal itself,
+never from piped input or keys typed earlier, so run `atem pair` in an
+interactive terminal. If verification fails, the pairing stays saved, Astation
+is told, and `atem pair` exits nonzero; run it again to verify. A connected or SSO-paired session alone does not
 mean the device is verified; check `atem cred status`. With `--save`
 the credentials keep working when Astation disconnects; without it they stop
 5 minutes after the disconnect (atem asks when `--save` isn't given).
@@ -101,6 +104,9 @@ atem token rtm create --rtm-user-id bob --expire 3600
 atem token rtm decode <token>           # Decode existing Signaling (RTM) token
 ```
 
+The token code is also a Rust library, `atem-core`, in the
+[GitHub repository](https://github.com/Agora-Build/Atem/tree/main/crates/atem-core). The npm package installs the CLI only.
+
 ### Projects
 
 ```bash
@@ -157,7 +163,7 @@ atem memory search "valkey"                      # Local full-text search (offli
 atem memory replace <id> "the fact as it is now" # New fact replaces the old one (history kept)
 atem memory invalidate <id>                      # Mark outdated without a replacement
 atem memory rm <id>                              # Remove everywhere
-atem memory purge <id>                           # Remove a fact that contained a credential, stop re-harvesting it
+atem memory purge <id> [--yes]                   # Remove a fact that contained a credential, stop re-harvesting it (asks first)
 atem memory apply                                # Rewrite the managed blocks and skills from the local store
 atem memory status                               # Account, machine, project, pending changes
 
@@ -166,7 +172,7 @@ atem skill list
 atem skill rm <name>                             # Remove everywhere
 atem skill history <name>                        # Every version, newest first
 atem skill restore <name> --version 3            # Re-push an old version as a new one
-atem skill purge <name> --version 3              # Erase versions that contained a credential (or --all-versions)
+atem skill purge <name> --version 3 [--yes]      # Erase versions that contained a credential (or --all-versions; asks first)
 ```
 
 Listings show short ids like `8245ecf6…e6fe` (first 8 + last 4 characters).
@@ -258,14 +264,42 @@ done
 
 ```bash
 atem agent list                         # Scan and list detected AI agents
-atem agent launch                       # Launch Claude Code as PTY agent
-atem agent launch codex                 # Launch Codex as PTY agent
+atem agent launch                       # Open the original Claude Code CLI in an Atem terminal
+atem agent launch codex                 # Open the original Codex CLI in an Atem terminal
+atem agent launch claude --continue     # Arguments after the agent type go to that CLI: continue the last Claude session
+atem agent launch codex resume --last   # Continue the last Codex session
+atem agent launch claude -- --help      # Use -- to read the agent's own help
 atem agent connect <WS_URL>             # Connect to ACP agent and show info
 atem agent prompt <WS_URL> "text"       # Send prompt to ACP agent
 atem agent probe <WS_URL>              # Probe URL for ACP support
 atem agent visualize "topic"            # Generate visual HTML diagram via ACP agent
 ```
 
+`atem agent launch [claude|claude-code|codex] [ARGS]...` runs the installed
+`claude` or `codex` CLI, unchanged, in a full-screen Atem terminal. It uses
+your working directory and your own login for that CLI. Nothing here replaces
+the CLI with an API conversation. It works without Astation. If you are
+paired, Astation can view the same session and take control of it (one
+viewer per session; while Astation holds control, local typing is refused until you press
+the prefix, then `g`). Quitting Atem ends the session.
+
+Atem's own keys start with a prefix, Ctrl+] by default. Press it, then:
+
+| Key | Action |
+|-----|--------|
+| `h` | Hide the terminal; the agent keeps running |
+| `g` | Take control back locally |
+| `x` | Stop the agent |
+| `r` | Redraw the screen |
+| `[` | Browse local history (arrows, Space to select, Enter to copy, Esc to return) |
+| `c` | Copy the visible text (tmux buffer inside tmux, otherwise OSC 52) |
+| `?` | Help and recent notices |
+
+Press the prefix twice to send it to the agent. Set `ATEM_TERMINAL_PREFIX`
+(for example `Ctrl-a`) to change it. The `CLAUDE_CLI_BIN`/`CLAUDE_CLI_ARGS`
+and `CODEX_CLI_BIN`/`CODEX_CLI_ARGS` variables still override the command.
+See [`designs/terminal-v1-implementation.md`](https://github.com/Agora-Build/Atem/blob/main/designs/terminal-v1-implementation.md).
+
 ## TUI Modes
 
 | Mode | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agora-build/atem",
-  "version": "0.6.12",
+  "version": "0.6.15",
   "description": "A terminal that connects people, Agora platform, and AI agents.",
   "bin": {
     "atem": "bin/atem"