Light Terminal — AI skill for Claude Code
Lightweight tmux-compatible terminal session daemon for AI coding agents.
How to install Light Terminal
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open ictechgy/light_terminal and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Light Terminal does
Lightweight tmux-compatible terminal session daemon for AI coding agents. Persistent PTY sessions, cmux-friendly notifications, and built-in launchers for Claude, Codex, Gemini, Cursor, Antigravity, and more.
Alternatives in AI
- Nocturne Memory — A lightweight, rollbackable, and visual Long-Term Memory Server for MCP Agents 1.3k ★
- Cc Mini — Ultra-light Harness scaffolding for AI agents, a mini version of claude code 825 ★
- onWatch — Open-source Go CLI that tracks AI API quota usage across 7 providers (Synthetic, Z.ai, Anthropic, Codex, GitHu 397 ★
README
Light Terminal (`lterm`)
[한국어](README.ko.md) | English | 🌐 [Browser-friendly HTML guide](https://ictechgy.github.io/light_terminal/)
TL;DR
- What — A persistent terminal session daemon (like tmux, but smaller) with a tmux-compatible command layer for AI-agent tooling. Detach and reattach by name or pane id.
- Who it's for — Terminal-first coding agents such as Claude Code, Codex CLI, OpenCode, GitHub Copilot CLI, Cursor Agent, Antigravity/
agy, Kiro, Jules, Aider, Goose, Amp, Crush, Kimi, Qwen, Gemini CLI, Grok Build CLI via customlterm agent grok,oh-my-codex/oh-my-claude, and users running them insidecmux. - How — Use
lterm startto create a session,lterm resumeto reconnect, andlterm agent/lterm claude/lterm codex/lterm opencode/lterm agy/lterm kiro/lterm geminifor built-in shimmed agent launchers. Inside a tmux-enabled session, thetmuxcommand resolves tolterm tmux-compat. - Status — 1.x CLI with a documented 1.0 command/output compatibility boundary. It is a same-user convenience daemon — not a sandbox, an escape-sequence sanitizer, or a full tmux replacement.
`lterm` is intentionally smaller than tmux. It keeps long-running PTY sessions alive, lets clients detach and reattach at will, forwards terminal escape sequences unchanged, and translates the tmux command subset commonly used by terminal-first agent tooling.
**Security model:** `lterm` is a same-user convenience daemon, not a sandbox. It rejects cross-user Unix-socket peers and uses owner-only runtime directories, but any process running as your OS user should be considered capable of controlling your sessions. See [SECURITY.md](SECURITY.md) for the full trust-boundary and audit policy details. Non-goals: see [docs/non-goals.md](docs/non-goals.md).
Current release: 1.0.33
The 1.0.33 release restores nested session provenance across environment-stripping wrappers while preserving explicit authority
Related Skills
Agmsg Cmux Bridge
Bridges CLI AI agents (Claude Code, Codex, Gemini CLI, and more) over local SQLite with tmux/cmux/wezterm turn
Aria Knowledge
Applied reasoning, persistent agent memory, context engineering, and human-governed trust for AI coding agents
Agent Daemon Rb
Ruby daemon engine for orchestrating CLI AI agents (Claude Code, OpenCode) with triggers, prompt templates, an
Vibeharness
Hackable, interactive LLM agent harness for the terminal — streaming REPL, tool-using agent loop, persistent P
Tmux Canopy
A tmux workspace tree and AI-agent monitor in one sidebar, with no daemon. Tracks Claude Code, Codex, OpenCode
Claude Code Notification
A lightweight macOS desktop notification hook for Claude Code that displays native notifications with customiz
Related Agents
Terminal Engineer
Use for SwiftTerm integration, PTY process spawning, ssh and tmux command building, hosts config loading, reco
Tui UX
Terminal-UI (TUI) UX expert. Validates TUI work by rendering it to light/dark images offline (and driving it o
Monk Installer
Install, upgrade, and troubleshoot monk-agent plus Monk CLI/daemon for Claude, Codex, and Cursor users.