@layorixinc/axterm 0.6.1 → 0.8.0
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.
- package/README.md +10 -10
- package/dist/cli.js +17216 -5657
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -3,27 +3,26 @@
|
|
|
3
3
|
Run CLI coding agents as managed background sessions, and drive them from a messenger.
|
|
4
4
|
|
|
5
5
|
An agent in a terminal tab dies when you close the tab, and you can only watch it while you are
|
|
6
|
-
sitting in front of it. axterm keeps the agent in a
|
|
7
|
-
topic, and lets you approve tool calls, answer questions, and send new prompts from your
|
|
8
|
-
No cloud relay: each machine only makes outbound connections.
|
|
6
|
+
sitting in front of it. axterm keeps the agent in a background terminal host, mirrors it into a
|
|
7
|
+
Telegram topic, and lets you approve tool calls, answer questions, and send new prompts from your
|
|
8
|
+
phone. No cloud relay: each machine only makes outbound connections.
|
|
9
9
|
|
|
10
10
|
```
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
└─────────┘────▶ PTY ──▶ agent (worktree: feat-b)
|
|
11
|
+
Telegram ◀────▶ daemon ◀────▶ terminal host ───▶ PTY ───▶ agent (omp)
|
|
12
|
+
CLI ◀────┘ ├────▶ PTY ───▶ agent (feat-a)
|
|
13
|
+
└────▶ PTY ───▶ agent (feat-b)
|
|
15
14
|
```
|
|
16
15
|
|
|
17
16
|
## What it does
|
|
18
17
|
|
|
19
|
-
- **Sessions outlive your terminal.** The
|
|
18
|
+
- **Sessions outlive your terminal and daemon.** The terminal host owns the PTY; attach and detach with `Ctrl+X Ctrl+X`.
|
|
20
19
|
- **Telegram as a control surface.** One forum topic per session: streamed output, approval buttons,
|
|
21
20
|
structured questions with multi-select and free text, and plain messages delivered as prompts.
|
|
22
21
|
- **Parallel work on git worktrees.** `--worktree` gives each session its own branch and checkout;
|
|
23
22
|
`fanout` starts the same prompt on several branches; `diff` summarizes the result, untracked files
|
|
24
23
|
included.
|
|
25
|
-
- **
|
|
26
|
-
|
|
24
|
+
- **Crash recovery and resume.** The OS can restart a failed daemon and adopt the same live PTY. A
|
|
25
|
+
killed agent can still resume with its conversation and Telegram topic intact.
|
|
27
26
|
- **Several machines, one group.** Address a specific PC with `machine:project`; each machine runs
|
|
28
27
|
its own bot.
|
|
29
28
|
- **English and Korean** for every user-facing string.
|
|
@@ -46,6 +45,7 @@ a stable home for that.
|
|
|
46
45
|
|
|
47
46
|
```bash
|
|
48
47
|
axterm run # start an agent here and attach
|
|
48
|
+
axterm service install # start at login and restart daemon failures
|
|
49
49
|
axterm list # what is running
|
|
50
50
|
axterm resume <id> # bring an exited session back
|
|
51
51
|
```
|