@agora-build/atem 0.6.13 → 0.6.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +35 -2
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -104,6 +104,9 @@ atem token rtm create --rtm-user-id bob --expire 3600
104
104
  atem token rtm decode <token> # Decode existing Signaling (RTM) token
105
105
  ```
106
106
 
107
+ The token code is also a Rust library, `atem-core`, in the
108
+ [GitHub repository](https://github.com/Agora-Build/Atem/tree/main/crates/atem-core). The npm package installs the CLI only.
109
+
107
110
  ### Projects
108
111
 
109
112
  ```bash
@@ -261,14 +264,44 @@ done
261
264
 
262
265
  ```bash
263
266
  atem agent list # Scan and list detected AI agents
264
- atem agent launch # Launch Claude Code as PTY agent
265
- atem agent launch codex # Launch Codex as PTY agent
267
+ atem agent launch # Open the original Claude Code CLI in an Atem terminal
268
+ atem agent launch codex # Open the original Codex CLI in an Atem terminal
269
+ atem agent launch claude --continue # Arguments after the agent type go to that CLI: continue the last Claude session
270
+ atem agent launch codex resume --last # Continue the last Codex session
271
+ atem agent launch claude -- --help # Use -- to read the agent's own help
266
272
  atem agent connect <WS_URL> # Connect to ACP agent and show info
267
273
  atem agent prompt <WS_URL> "text" # Send prompt to ACP agent
268
274
  atem agent probe <WS_URL> # Probe URL for ACP support
269
275
  atem agent visualize "topic" # Generate visual HTML diagram via ACP agent
270
276
  ```
271
277
 
278
+ `atem agent launch [claude|claude-code|codex] [ARGS]...` runs the installed
279
+ `claude` or `codex` CLI, unchanged, in a full-screen Atem terminal. It uses
280
+ your working directory and your own login for that CLI. Nothing here replaces
281
+ the CLI with an API conversation. It works without Astation. If you are
282
+ paired, Astation can view the same session and take control of it (one
283
+ viewer per session; while Astation holds control, local typing is refused until you press
284
+ the prefix, then `g`). Quitting Atem ends the session.
285
+
286
+ Atem's own keys start with a prefix, Ctrl+] by default. Press it, then:
287
+
288
+ | Key | Action |
289
+ |-----|--------|
290
+ | `h` | Hide the terminal; the agent keeps running |
291
+ | `g` | Take control back locally |
292
+ | `x` | Stop the agent |
293
+ | `r` | Redraw the screen |
294
+ | `[` | Browse local history (arrows, Space to select, Enter to copy, Esc to return) |
295
+ | `c` | Copy the visible text (tmux buffer inside tmux, otherwise OSC 52) |
296
+ | `?` | Help and recent notices |
297
+
298
+ Press the prefix twice to send it to the agent. To change it, set
299
+ `terminal_prefix = "Ctrl-a"` in `~/.config/atem/config.toml`, or
300
+ `ATEM_TERMINAL_PREFIX` (which wins over the file). Ctrl+], Ctrl+\ or
301
+ Ctrl+<letter> other than i or m are accepted. The `CLAUDE_CLI_BIN`/`CLAUDE_CLI_ARGS`
302
+ and `CODEX_CLI_BIN`/`CODEX_CLI_ARGS` variables still override the command.
303
+ See [`designs/terminal-v1-implementation.md`](https://github.com/Agora-Build/Atem/blob/main/designs/terminal-v1-implementation.md).
304
+
272
305
  ## TUI Modes
273
306
 
274
307
  | Mode | Description |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agora-build/atem",
3
- "version": "0.6.13",
3
+ "version": "0.6.17",
4
4
  "description": "A terminal that connects people, Agora platform, and AI agents.",
5
5
  "bin": {
6
6
  "atem": "bin/atem"