@dmsdc-ai/aigentry-telepty 0.6.6 → 0.6.7
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 +38 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
**Connect any terminal to any terminal, any machine.**
|
|
4
4
|
|
|
5
|
-
telepty is a
|
|
5
|
+
telepty is a PTY orchestration daemon and session bridge for AI CLI workflows. It lets you spawn, attach to, and inject commands into terminal sessions — locally or across machines via Tailscale.
|
|
6
6
|
|
|
7
7
|
Built for AI CLI workflows (Claude Code, Codex, Gemini CLI), but works with any interactive terminal program.
|
|
8
8
|
|
|
@@ -43,6 +43,43 @@ telepty attach my-session
|
|
|
43
43
|
telepty broadcast "status report"
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
+
## What telepty is — and what it is not
|
|
47
|
+
|
|
48
|
+
telepty is a **PTY orchestration daemon for AI CLI workflows**.
|
|
49
|
+
It is **not** a terminal multiplexer and does not replace tmux.
|
|
50
|
+
|
|
51
|
+
> **tmux is better at being a terminal. telepty is better at letting
|
|
52
|
+
> software operate many terminals.**
|
|
53
|
+
|
|
54
|
+
tmux owns terminal *fidelity*: panes, windows, full VT emulation, scrollback,
|
|
55
|
+
copy-mode, capture-pane, local Unix-socket operation, zero runtime deps.
|
|
56
|
+
telepty owns *automation*: HTTP/WS APIs, authenticated remote access,
|
|
57
|
+
readiness-aware inject/submit, event streams, cross-machine session control.
|
|
58
|
+
|
|
59
|
+
## telepty vs tmux
|
|
60
|
+
|
|
61
|
+
| Area | tmux | telepty |
|
|
62
|
+
|---|---|---|
|
|
63
|
+
| Core layer | terminal multiplexer + emulator | PTY orchestration daemon |
|
|
64
|
+
| Primary user | a human at a keyboard | software / an orchestrator |
|
|
65
|
+
| Terminal fidelity | full VT/grid/scrollback/copy-mode | output stream + heuristic state |
|
|
66
|
+
| IPC | local Unix socket | HTTP/WS/REST daemon (:3848) |
|
|
67
|
+
| Input model | open-loop `send-keys` | readiness-gated inject/submit |
|
|
68
|
+
| Multi-session fan-out | `synchronize-panes` (1 window, 1 host) | broadcast/multicast (cross-machine) |
|
|
69
|
+
| Remote | via SSH | native daemon HTTP, no sshd |
|
|
70
|
+
| Dependencies | zero runtime deps (C) | Node daemon + deps |
|
|
71
|
+
|
|
72
|
+
## When to use which
|
|
73
|
+
- **Use tmux** for panes, scrollback, copy-mode, capture-pane, and local
|
|
74
|
+
human terminal work — telepty does none of this and doesn't try to.
|
|
75
|
+
- **Use telepty** when software needs to spawn, inspect, inject into, and
|
|
76
|
+
track many AI-CLI sessions over an API — across machines.
|
|
77
|
+
|
|
78
|
+
## Limitations (honest)
|
|
79
|
+
- No terminal emulation: no cell grid, cursor model, or copy-mode. Screen
|
|
80
|
+
reads are buffered bytes + heuristic state, not a ground-truth screen.
|
|
81
|
+
- Requires a background daemon and a network port (:3848, auth-gated).
|
|
82
|
+
|
|
46
83
|
## Core Commands
|
|
47
84
|
|
|
48
85
|
| Command | Description |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dmsdc-ai/aigentry-telepty",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.7",
|
|
4
4
|
"main": "daemon.js",
|
|
5
5
|
"bin": {
|
|
6
6
|
"aigentry-telepty": "install.js",
|
|
@@ -60,7 +60,7 @@
|
|
|
60
60
|
"tailscale"
|
|
61
61
|
],
|
|
62
62
|
"author": "dmsdc-ai",
|
|
63
|
-
"license": "
|
|
63
|
+
"license": "MIT",
|
|
64
64
|
"description": "Universal terminal session bridge — connect any terminal to any terminal, any machine",
|
|
65
65
|
"repository": {
|
|
66
66
|
"type": "git",
|