Skip to content

agent-install.md

Latest commit

 

History

History
59 lines (51 loc) · 2.71 KB

agent-install.md

File metadata and controls

59 lines (51 loc) · 2.71 KB

Agent install prompt for lterm

Copy this prompt into Claude Code, Codex CLI, OpenCode, GitHub Copilot CLI, Cursor Agent, Antigravity/agy, Kiro, Jules, Aider, Goose, Amp, Crush, Kimi, Qwen, Gemini CLI, or another terminal coding agent when you want the agent to install and verify lterm for you.

You are installing `lterm`, a lightweight tmux-compatible terminal session daemon
for AI-agent workflows.

Goal: install `lterm`, verify it works, and leave me with the exact command I can
use to start an agent-backed persistent session.

Repository: https://github.com/ictechgy/light_terminal
Current release tag to prefer for source installs: v1.0.12

Rules:
- Detect OS, CPU architecture, shell, and whether Homebrew, npm, and Cargo are available.
- Prefer the least surprising package manager for this machine:
  - macOS with Homebrew: `brew install ictechgy/tap/lterm`
  - supported macOS/Linux with npm: `npm install -g @ictechgy/lterm`
  - fallback with Rust/Cargo: `cargo install --git https://github.com/ictechgy/light_terminal --tag v1.0.12`
- If an older `lterm` daemon may still be running after an upgrade, show current sessions first with `lterm sessions --all` and ask before running `lterm shutdown`.
- Do not overwrite shell startup files. If PATH/shim setup needs `.zshrc`, `.bashrc`, `.profile`, or fish config changes, show the exact diff and ask first.
- Keep raw terminal attach behavior untouched; only run smoke-test commands that are safe and reversible.

After installing, verify:
1. `lterm --version`
2. `lterm doctor --json`
3. `lterm start --detach --name lterm-smoke -- sh -lc 'echo LTERM_SMOKE_READY; sleep 2'`
4. Poll `lterm logs lterm-smoke --start=-20` until it contains `LTERM_SMOKE_READY`.
5. `lterm processes lterm-smoke --json`
6. `lterm close lterm-smoke`
7. `lterm doctor`

Then print:
- Installed version and install method.
- Whether the shim directory is on PATH.
- Any shell config change I still need to approve.
- One recommended first command for my agent workflow, for example:
  - `lterm claude --name claude-main`
  - `lterm codex --name codex-main`
  - `lterm opencode --name opencode-main`
  - `lterm copilot --name copilot-main`
  - `lterm cursor-agent --name cursor-main`
  - `lterm agy --name agy-main`
  - `lterm kiro --name kiro-main`
  - `lterm jules --name jules-main`
  - `lterm aider --name aider-main`
  - `lterm goose --name goose-main`
  - `lterm amp --name amp-main`
  - `lterm crush --name crush-main`
  - `lterm kimi --name kimi-main`
  - `lterm qwen --name qwen-main`
  - `lterm gemini --name gemini-main`
  - `lterm omx --name omx-main`

If the agent reports a stale daemon/version mismatch, finish important sessions first, then run lterm shutdown and retry the verification commands.