@dmsdc-ai/aigentry-telepty 0.3.3 → 0.3.5

package/skill-installer.js

@@ -1,8 +1,10 @@
+// LEGACY: grandfathered by ADR 2026-05-05-telepty-devkit-boundary §6.2.1. New installer behavior MUST land in @dmsdc-ai/aigentry-devkit. Bugfixes only.
 'use strict';
 
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
+const { execSync } = require('child_process');
 const prompts = require('prompts');
 
 const TARGET_CLIENTS = {
@@ -10,22 +12,44 @@ const TARGET_CLIENTS = {
     label: 'Claude Code',
     globalDir: () => path.join(os.homedir(), '.claude', 'skills'),
     projectDir: (cwd) => path.join(cwd, '.claude', 'skills'),
-    defaultScope: 'global'
+    defaultScope: 'global',
+    homeDir: () => path.join(os.homedir(), '.claude'),
+    binary: 'claude'
   },
   codex: {
     label: 'Codex',
     globalDir: () => path.join(os.homedir(), '.codex', 'skills'),
     projectDir: (cwd) => path.join(cwd, '.codex', 'skills'),
-    defaultScope: 'global'
+    defaultScope: 'global',
+    homeDir: () => path.join(os.homedir(), '.codex'),
+    binary: 'codex'
   },
   gemini: {
     label: 'Gemini',
     globalDir: () => path.join(os.homedir(), '.gemini', 'skills'),
     projectDir: (cwd) => path.join(cwd, '.gemini', 'skills'),
-    defaultScope: 'project'
+    defaultScope: 'project',
+    homeDir: () => path.join(os.homedir(), '.gemini'),
+    binary: 'gemini'
   }
 };
 
+function hasCliBinary(cmd) {
+  try {
+    execSync(`command -v ${cmd}`, { stdio: 'ignore', shell: '/bin/sh' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function detectInstalledClients() {
+  return Object.keys(TARGET_CLIENTS).filter((key) => {
+    const client = TARGET_CLIENTS[key];
+    return fs.existsSync(client.homeDir()) || hasCliBinary(client.binary);
+  });
+}
+
 function resolveSkillsSourceRoot(packageRoot = __dirname) {
   return path.join(packageRoot, 'skills');
 }
@@ -163,13 +187,23 @@ async function runInteractiveSkillInstaller(options = {}) {
     console.log(`Installing packaged skill: ${packagedSkills[0].name}`);
   }
 
+  const installedClients = options.detectClients
+    ? options.detectClients()
+    : detectInstalledClients();
+  const installedSet = new Set(installedClients);
+  const detectedLabel = installedClients.length
+    ? `Detected: ${installedClients.join(', ')}`
+    : 'No AI CLI detected — manual selection required';
+  console.log(detectedLabel);
+
   const selectedClientsAnswer = await promptImpl({
     type: 'multiselect',
     name: 'clients',
-    message: 'Select target clients',
+    message: 'Select target clients (detected CLIs pre-selected)',
     choices: Object.entries(TARGET_CLIENTS).map(([key, value]) => ({
-      title: value.label,
-      value: key
+      title: `${value.label}${installedSet.has(key) ? ' ✓ detected' : ' (not detected)'}`,
+      value: key,
+      selected: installedSet.has(key)
     })),
     min: 1
   });
@@ -262,6 +296,8 @@ async function runInteractiveSkillInstaller(options = {}) {
 module.exports = {
   TARGET_CLIENTS,
   copySkillDirectory,
+  detectInstalledClients,
+  hasCliBinary,
   installSkillsWithPlan,
   listPackagedSkills,
   resolveTargetDirectory,

package/skills/telepty/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty
-description: Overview of telepty — PTY multiplexer for AI session orchestration. Use this when user asks "what is telepty" or needs a getting-started guide.
+description: Overview of telepty — PTY multiplexer for AI session orchestration. Use this when user asks "what is telepty" or needs a getting-started guide. 키워드: 텔레프티, 텔레프티 개요, 시작하기, telepty 소개, 사용법, 가이드
 ---
 
 # telepty — Overview

package/skills/telepty-allow/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty-allow
-description: Create telepty sessions by wrapping CLI processes. Covers the allow/enable/wrap command for session creation and PTY management.
+description: Create telepty sessions by wrapping CLI processes. Covers the allow/enable/wrap command for session creation and PTY management. 키워드: 세션 생성, 세션 래핑, CLI 래핑, allow, 세션 만들기, PTY
 ---
 
 # telepty-allow — Create and Manage Sessions

package/skills/telepty-attach/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty-attach
-description: Attach interactively to a telepty session to view output and send input in real-time.
+description: Attach interactively to a telepty session to view output and send input in real-time. 키워드: 세션 접속, 세션 연결, 세션 들어가기, 어태치, attach, 실시간 보기
 ---
 
 # telepty-attach — Interactive Session Attachment

package/skills/telepty-broadcast/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty-broadcast
-description: Send messages to multiple telepty sessions at once. Covers broadcast (all sessions) and multicast (selected targets).
+description: Send messages to multiple telepty sessions at once. Covers broadcast (all sessions) and multicast (selected targets). 키워드: 전체 공지, 모든 세션에, 일괄 전송, 브로드캐스트, 멀티캐스트, 다중 주입
 ---
 
 # telepty-broadcast — Multi-Target Messaging

package/skills/telepty-daemon/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty-daemon
-description: Manage the telepty daemon — start, stop, repair, update, and TUI dashboard. Use when daemon is broken or needs maintenance.
+description: Manage the telepty daemon — start, stop, repair, update, and TUI dashboard. Use when daemon is broken or needs maintenance. 키워드: 데몬 시작, 데몬 재시작, 데몬 종료, TUI, 대시보드, 데몬 상태, daemon
 ---
 
 # telepty-daemon — Daemon Management

package/skills/telepty-inject/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty-inject
-description: Send messages, commands, and keystrokes to telepty sessions. Covers inject, enter, send-key, and reply commands.
+description: Send messages, commands, and keystrokes to telepty sessions. Covers inject, enter, send-key, and reply commands. 키워드: 세션에 메시지, 메시지 보내기, 전달, 주입, inject, 응답, 답장, 키 입력
 ---
 
 # telepty-inject — Send Messages to Sessions
@@ -51,14 +51,34 @@ If you expect a reply, ALWAYS include `--from` so the target knows where to resp
 telepty inject <target> "your message" --from $(echo $TELEPTY_SESSION_ID)
 ```
 
-### Cross-host inject
+### Cross-host inject — `<id>@<host>` syntax
 
-When the same session ID exists on multiple hosts:
+To inject into a session running on a different machine, append `@<host>` to
+the session ID. `<host>` can be a hostname, LAN IP, or Tailnet name.
 
 ```bash
-telepty inject session_id@remote-host "message"
+# Hostname
+telepty inject session_id@worker-01 "message"
+
+# LAN IP (daemon must be reachable on port 3848)
+telepty inject orchestrator-claude@172.28.4.165 "PING from build server"
+
+# With return address (recommended for cross-host)
+telepty inject orchestrator-claude@192.168.1.10 "task done" \
+  --from "$TELEPTY_SESSION_ID"
 ```
 
+**Requirements**:
+- The remote daemon must be reachable on port `3848` from the calling host
+  (firewall / LAN routing / Tailscale).
+- No SSH or sshd is required on either side — the call hits the remote
+  daemon's HTTP API directly.
+- Use the same `<id>@<host>` syntax for `attach`, `read-screen`, `enter`,
+  and `multicast` targets.
+
+Use this when the same session ID exists on multiple hosts, or when the
+calling host has no local daemon discovery (no Tailnet, mixed LAN, etc.).
+
 ## enter — Send Enter keystroke only
 
 ```bash
@@ -83,6 +103,58 @@ telepty reply "<message>"
 
 Automatically targets the session that last injected into yours (uses stored `lastInjectFrom`).
 
+## Report Convention (REPORT to orchestrator)
+
+When a sub-session finishes a task or needs to escalate state, it reports to the
+**orchestrator** session using the `REPORT:` prefix.
+
+### Hard rule: NEVER hardcode the orchestrator session ID
+
+Session IDs are volatile runtime identifiers — they may change across hosts,
+restarts, or topology shifts. Resolve the orchestrator ID at runtime from
+`telepty list --json` instead.
+
+### Standard pattern (telepty 0.3.3+)
+
+```bash
+# 1. Resolve orchestrator session ID at runtime (filter out role-suffixed peers)
+ORCH_ID=$(telepty list --json | python3 -c "import json,sys; \
+  print(next(s['id'] for s in json.load(sys.stdin) \
+    if 'orchestrator' in s['id'] \
+    and not any(x in s['id'] for x in ('coder','reviewer','architect','runner','tester','analyst','builder'))))")
+
+# 2. Inject the REPORT (retry-safe submit; --ref keeps payload short)
+telepty inject --ref --submit --submit-retry 2 \
+  --from "$TELEPTY_SESSION_ID" "$ORCH_ID" \
+  "REPORT: <one-line summary> | evidence: <commit/test/etc> | next: <handoff>"
+```
+
+### Convention rules
+
+- **Prefix**: messages MUST start with `REPORT:` so the orchestrator's event
+  classifier can route them.
+- **Return address**: include `--from "$TELEPTY_SESSION_ID"` so the orchestrator
+  knows which sub-session reported.
+- **Retry**: pass `--submit-retry 2` (telepty 0.3.3+). The retry is idempotent
+  on safe gate-timeout 504s (`gated_dispatch_unconsumed`, `gate_timeout`,
+  `no_prompt_symbol_seen`); hard-fail reasons (`session_dead`, `error`,
+  `restarting`, `no_state`) are not retried.
+- **Long payloads**: store the full body in a file and use `--ref <file>` so the
+  inject prompt itself stays short.
+- **Self-report (idempotent)**: a session reporting on its own behalf may use
+  `--submit-force` to bypass the render gate. Do NOT use `--submit-force` for
+  general inject — it can clobber in-flight user input.
+
+### Anti-patterns (DO NOT)
+
+- `telepty inject orchestrator-claude "..."` — hardcoded session ID; breaks the
+  moment the orchestrator is renamed or runs under a different CLI (codex,
+  gemini).
+- Embedding `aigentry-orchestrator-claude` in spec templates, scripts, or
+  docs as a literal target.
+- Reporting without the `REPORT:` prefix — the orchestrator cannot distinguish
+  a status report from a peer-to-peer message.
+
 ## Common Errors
 
 | Error | Cause | Fix |

package/skills/telepty-list/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty-list
-description: Discover telepty sessions, check status and health. Covers list, session info, and status commands.
+description: Discover telepty sessions, check status and health. Covers list, session info, and status commands. 키워드: 세션 목록, 활성 세션, 세션 조회, 세션 상태, 세션 확인, 리스트
 ---
 
 # telepty-list — Discover Sessions and Check Status

package/skills/telepty-listen/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty-listen
-description: Monitor telepty events and read session screen output. Covers listen (event bus) and read-screen commands.
+description: Monitor telepty events and read session screen output. Covers listen (event bus) and read-screen commands. 키워드: 이벤트 모니터, 화면 확인, 화면 읽기, 이벤트 스트림, listen, read-screen, 모니터링
 ---
 
 # telepty-listen — Event Monitoring and Screen Reading

package/skills/telepty-rename/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty-rename
-description: Rename, delete, and clean up telepty sessions. Session lifecycle management.
+description: Rename, delete, and clean up telepty sessions. Session lifecycle management. 키워드: 세션 이름 변경, 세션 삭제, 세션 정리, 세션 청소, rename, 라이프사이클
 ---
 
 # telepty-rename — Session Lifecycle Management

package/skills/telepty-session/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: telepty-session
-description: Multi-session orchestration — start multiple sessions at once and arrange terminal layouts. Covers session start and layout commands.
+description: Multi-session orchestration — start multiple sessions at once and arrange terminal layouts. Covers session start and layout commands. 키워드: 멀티 세션 시작, 다중 세션, 세션 레이아웃, 세션 일괄 시작, 멀티 시작, layout
 ---
 
 # telepty-session — Multi-Session Orchestration

package/src/init/print-snippet.js

@@ -0,0 +1,114 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { createHash } = require('node:crypto');
+
+const VERSION = 'telepty-snippet/v1';
+const TARGETS = ['claude', 'agents', 'gemini'];
+const FORMATS = ['markdown', 'json'];
+const SNIPPET_DIR = path.join(__dirname, 'snippets');
+const HELP = 'usage: telepty init --print-snippet [--target {claude|agents|gemini|all}] [--format {markdown|json}]';
+
+function sha256Hex(body) {
+  return createHash('sha256').update(body, 'utf8').digest('hex');
+}
+
+function loadBody(target, options = {}) {
+  const snippetDir = options.snippetDir || SNIPPET_DIR;
+  return fs.readFileSync(path.join(snippetDir, `${target}.md`), 'utf8');
+}
+
+function expandTargets(target) {
+  return target === 'all' ? TARGETS : [target];
+}
+
+function emitMarkdown(target, body) {
+  const sha8 = sha256Hex(body).slice(0, 8);
+  return `<!-- ${VERSION} BEGIN target=${target} sha256=${sha8} -->\n${body}<!-- ${VERSION} END target=${target} -->\n`;
+}
+
+function emitJson(target, body) {
+  return JSON.stringify({
+    version: VERSION,
+    target,
+    sha256: sha256Hex(body),
+    body
+  }) + '\n';
+}
+
+function parseArgs(args) {
+  const parsed = {
+    printSnippet: false,
+    target: 'all',
+    format: 'markdown',
+    help: false
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === '--help' || arg === '-h') {
+      parsed.help = true;
+    } else if (arg === '--print-snippet') {
+      parsed.printSnippet = true;
+    } else if (arg === '--target') {
+      parsed.target = args[index + 1] || '';
+      index += 1;
+    } else if (arg.startsWith('--target=')) {
+      parsed.target = arg.slice('--target='.length);
+    } else if (arg === '--format') {
+      parsed.format = args[index + 1] || '';
+      index += 1;
+    } else if (arg.startsWith('--format=')) {
+      parsed.format = arg.slice('--format='.length);
+    }
+  }
+
+  return parsed;
+}
+
+function buildOutput(args, options = {}) {
+  const parsed = parseArgs(args);
+  const stdout = options.stdout || process.stdout;
+  const stderr = options.stderr || process.stderr;
+
+  if (parsed.help || !parsed.printSnippet) {
+    stdout.write(`${HELP}\n`);
+    return 0;
+  }
+
+  if (![...TARGETS, 'all'].includes(parsed.target)) {
+    stderr.write('error: --target must be one of claude, agents, gemini, all\n');
+    return 2;
+  }
+
+  if (!FORMATS.includes(parsed.format)) {
+    stderr.write('error: --format must be one of markdown, json\n');
+    return 2;
+  }
+
+  try {
+    const outputs = expandTargets(parsed.target).map((target) => {
+      const body = loadBody(target, options);
+      return parsed.format === 'json' ? emitJson(target, body) : emitMarkdown(target, body);
+    });
+
+    stdout.write(parsed.format === 'json' ? outputs.join('') : outputs.join('\n'));
+    return 0;
+  } catch (error) {
+    stderr.write(`error: failed to generate telepty snippet: ${error.message}\n`);
+    return 4;
+  }
+}
+
+module.exports = {
+  HELP,
+  TARGETS,
+  VERSION,
+  buildOutput,
+  emitJson,
+  emitMarkdown,
+  loadBody,
+  main: buildOutput,
+  sha256Hex
+};

package/src/init/snippets/agents.md

@@ -0,0 +1,15 @@
+## telepty-snippet:agents
+
+**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.
+
+Quick-start (5 commands):
+
+    telepty daemon
+    telepty allow --id <name> claude
+    telepty list
+    telepty inject <name> "<prompt>"
+    telepty attach <name>
+
+`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.
+
+Run `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.

package/src/init/snippets/claude.md

@@ -0,0 +1,15 @@
+## telepty-snippet:claude
+
+**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.
+
+Quick-start (5 commands):
+
+    telepty daemon
+    telepty allow --id <name> claude
+    telepty list
+    telepty inject <name> "<prompt>"
+    telepty attach <name>
+
+`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.
+
+Run `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.

package/src/init/snippets/gemini.md

@@ -0,0 +1,15 @@
+## telepty-snippet:gemini
+
+**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.
+
+Quick-start (5 commands):
+
+    telepty daemon
+    telepty allow --id <name> claude
+    telepty list
+    telepty inject <name> "<prompt>"
+    telepty attach <name>
+
+`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.
+
+Run `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.

package/tests/snippet-protocol/v1/golden-agents.json

@@ -0,0 +1 @@
+{"version":"telepty-snippet/v1","target":"agents","sha256":"f5a0986a29a334ab0a12e672f4f3428c0c6f1458d35d6d0263a5ec3c33721195","body":"## telepty-snippet:agents\n\n**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.\n\nQuick-start (5 commands):\n\n    telepty daemon\n    telepty allow --id <name> claude\n    telepty list\n    telepty inject <name> \"<prompt>\"\n    telepty attach <name>\n\n`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.\n\nRun `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.\n"}

package/tests/snippet-protocol/v1/golden-agents.md

@@ -0,0 +1,17 @@
+<!-- telepty-snippet/v1 BEGIN target=agents sha256=f5a0986a -->
+## telepty-snippet:agents
+
+**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.
+
+Quick-start (5 commands):
+
+    telepty daemon
+    telepty allow --id <name> claude
+    telepty list
+    telepty inject <name> "<prompt>"
+    telepty attach <name>
+
+`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.
+
+Run `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.
+<!-- telepty-snippet/v1 END target=agents -->

package/tests/snippet-protocol/v1/golden-all.json

@@ -0,0 +1,3 @@
+{"version":"telepty-snippet/v1","target":"claude","sha256":"305aad8181c1e75bb94589386cbc34f2b5103d6b5c1f6a7f01c99f1fbf6ed8c3","body":"## telepty-snippet:claude\n\n**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.\n\nQuick-start (5 commands):\n\n    telepty daemon\n    telepty allow --id <name> claude\n    telepty list\n    telepty inject <name> \"<prompt>\"\n    telepty attach <name>\n\n`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.\n\nRun `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.\n"}
+{"version":"telepty-snippet/v1","target":"agents","sha256":"f5a0986a29a334ab0a12e672f4f3428c0c6f1458d35d6d0263a5ec3c33721195","body":"## telepty-snippet:agents\n\n**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.\n\nQuick-start (5 commands):\n\n    telepty daemon\n    telepty allow --id <name> claude\n    telepty list\n    telepty inject <name> \"<prompt>\"\n    telepty attach <name>\n\n`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.\n\nRun `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.\n"}
+{"version":"telepty-snippet/v1","target":"gemini","sha256":"c97635b0d684552aa060a969981c2be11cf49b60f5a6237d52f5214e9ecc1a07","body":"## telepty-snippet:gemini\n\n**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.\n\nQuick-start (5 commands):\n\n    telepty daemon\n    telepty allow --id <name> claude\n    telepty list\n    telepty inject <name> \"<prompt>\"\n    telepty attach <name>\n\n`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.\n\nRun `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.\n"}

package/tests/snippet-protocol/v1/golden-all.md

@@ -0,0 +1,53 @@
+<!-- telepty-snippet/v1 BEGIN target=claude sha256=305aad81 -->
+## telepty-snippet:claude
+
+**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.
+
+Quick-start (5 commands):
+
+    telepty daemon
+    telepty allow --id <name> claude
+    telepty list
+    telepty inject <name> "<prompt>"
+    telepty attach <name>
+
+`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.
+
+Run `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.
+<!-- telepty-snippet/v1 END target=claude -->
+
+<!-- telepty-snippet/v1 BEGIN target=agents sha256=f5a0986a -->
+## telepty-snippet:agents
+
+**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.
+
+Quick-start (5 commands):
+
+    telepty daemon
+    telepty allow --id <name> claude
+    telepty list
+    telepty inject <name> "<prompt>"
+    telepty attach <name>
+
+`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.
+
+Run `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.
+<!-- telepty-snippet/v1 END target=agents -->
+
+<!-- telepty-snippet/v1 BEGIN target=gemini sha256=c97635b0 -->
+## telepty-snippet:gemini
+
+**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.
+
+Quick-start (5 commands):
+
+    telepty daemon
+    telepty allow --id <name> claude
+    telepty list
+    telepty inject <name> "<prompt>"
+    telepty attach <name>
+
+`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.
+
+Run `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.
+<!-- telepty-snippet/v1 END target=gemini -->

package/tests/snippet-protocol/v1/golden-claude.json

@@ -0,0 +1 @@
+{"version":"telepty-snippet/v1","target":"claude","sha256":"305aad8181c1e75bb94589386cbc34f2b5103d6b5c1f6a7f01c99f1fbf6ed8c3","body":"## telepty-snippet:claude\n\n**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.\n\nQuick-start (5 commands):\n\n    telepty daemon\n    telepty allow --id <name> claude\n    telepty list\n    telepty inject <name> \"<prompt>\"\n    telepty attach <name>\n\n`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.\n\nRun `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.\n"}

package/tests/snippet-protocol/v1/golden-claude.md

@@ -0,0 +1,17 @@
+<!-- telepty-snippet/v1 BEGIN target=claude sha256=305aad81 -->
+## telepty-snippet:claude
+
+**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.
+
+Quick-start (5 commands):
+
+    telepty daemon
+    telepty allow --id <name> claude
+    telepty list
+    telepty inject <name> "<prompt>"
+    telepty attach <name>
+
+`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.
+
+Run `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.
+<!-- telepty-snippet/v1 END target=claude -->

package/tests/snippet-protocol/v1/golden-gemini.json

@@ -0,0 +1 @@
+{"version":"telepty-snippet/v1","target":"gemini","sha256":"c97635b0d684552aa060a969981c2be11cf49b60f5a6237d52f5214e9ecc1a07","body":"## telepty-snippet:gemini\n\n**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.\n\nQuick-start (5 commands):\n\n    telepty daemon\n    telepty allow --id <name> claude\n    telepty list\n    telepty inject <name> \"<prompt>\"\n    telepty attach <name>\n\n`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.\n\nRun `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.\n"}

package/tests/snippet-protocol/v1/golden-gemini.md

@@ -0,0 +1,17 @@
+<!-- telepty-snippet/v1 BEGIN target=gemini sha256=c97635b0 -->
+## telepty-snippet:gemini
+
+**telepty** is the aigentry ecosystem's PTY multiplexer and session orchestrator. It allows wrapping AI CLI sessions under stable IDs and addressing them across local and cross-machine boundaries via a daemon-mediated transport.
+
+Quick-start (5 commands):
+
+    telepty daemon
+    telepty allow --id <name> claude
+    telepty list
+    telepty inject <name> "<prompt>"
+    telepty attach <name>
+
+`telepty allow` wraps a CLI under the chosen `<name>`; `telepty list` enumerates known sessions; `telepty inject` sends a prompt to a wrapped session; `telepty attach` interactively connects to one.
+
+Run `telepty --help` for the full command list. Run `telepty <command> --help` for per-command flags.
+<!-- telepty-snippet/v1 END target=gemini -->