@ictechgy/lterm 1.0.2 → 1.0.4

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.
Files changed (3) hide show
  1. package/README.ko.md +28 -12
  2. package/README.md +30 -13
  3. package/package.json +5 -5
package/README.ko.md CHANGED
@@ -5,8 +5,8 @@
5
5
  ## TL;DR
6
6
 
7
7
  - **무엇** — tmux 같은 영속 터미널 세션 데몬을 더 작게 만든 도구. AI 에이전트 도구를 위한 tmux 호환 명령 계층을 제공하며, 세션을 이름이나 pane id로 detach·reattach할 수 있습니다.
8
- - **대상** — Claude Code, Codex CLI, Gemini CLI, `oh-my-codex` / `oh-my-claude` 같은 terminal-first coding agent를 쓰는 사용자와, 이를 `cmux` 안에서 실행하는 사용자.
9
- - **사용법** — `lterm start`로 만들고 `lterm resume`으로 (재)접속, shim이 적용된 agent 실행에는 `lterm agent <profile>` / `lterm claude` / `lterm codex` / `lterm gemini`. tmux가 켜진 세션 안에서는 `tmux` 명령이 `lterm tmux-compat`으로 해석됩니다.
8
+ - **대상** — Claude Code, Codex CLI, OpenCode, GitHub Copilot CLI, Cursor Agent, Antigravity/`agy`, Kiro, Jules, Aider, Goose, Amp, Crush, Kimi, Qwen, Gemini CLI, `oh-my-codex` / `oh-my-claude` 같은 terminal-first coding agent를 쓰는 사용자와, 이를 `cmux` 안에서 실행하는 사용자.
9
+ - **사용법** — `lterm start`로 만들고 `lterm resume`으로 (재)접속, shim이 적용된 agent 실행에는 `lterm agent <profile>` / `lterm claude` / `lterm codex` / `lterm opencode` / `lterm agy` / `lterm kiro` / `lterm gemini` 등 built-in shortcut입니다. tmux가 켜진 세션 안에서는 `tmux` 명령이 `lterm tmux-compat`으로 해석됩니다.
10
10
  - **상태** — alpha MVP. 같은 OS 사용자 안에서 쓰는 편의용 데몬이며, **샌드박스, escape-sequence sanitizer, 완전한 tmux 대체품 모두 아닙니다.**
11
11
 
12
12
  ---
@@ -26,7 +26,7 @@ agent가 보통 필요로 하는 더 작은 표면에 집중합니다.
26
26
  계속 실행되므로, 모든 workflow가 full tmux server를 직접 관리할 필요가
27
27
  적습니다.
28
28
  - **Agent가 기대하는 tmux 호환성** — `lterm tmux-compat`는 Claude Code, Codex
29
- CLI, Gemini CLI, OMX/OMC 같은 terminal-first tooling이 쓰는 tmux command
29
+ CLI, OpenCode, GitHub Copilot CLI, Cursor Agent, Antigravity/`agy`, Kiro, Jules, Aider, Goose, Amp, Crush, Kimi, Qwen, Gemini CLI, OMX/OMC 같은 terminal-first tooling이 쓰는 tmux command
30
30
  subset을 구현합니다.
31
31
  - **Raw attach, safe reports** — attach된 PTY stream은 TUI/interactive shell을
32
32
  위해 raw로 유지하고, `logs`, `capture`, `list`, `doctor` 같은 report surface는
@@ -43,7 +43,7 @@ agent가 보통 필요로 하는 더 작은 표면에 집중합니다.
43
43
 
44
44
  1. **tmux와 비슷한 세션 지속성과 원격 접속** — 세션은 백그라운드 데몬에서 실행되며, 이름이나 pane id로 attach/detach할 수 있습니다. 원격 호스트에 `lterm`이 설치되어 있다면 `lterm ssh`로 접속할 수 있습니다.
45
45
  2. **cmux 호환성** — cmux 안에서 실행할 때는 OSC 알림을 그대로 통과시키고 `lterm notify`를 제공하며, tmux shim은 가능한 경우 worker pane을 cmux native split으로 엽니다.
46
- 3. **AI 도구 지원** — `lterm agent <profile>`, `lterm claude`, `lterm codex`, `lterm gemini`, `lterm omx`, `lterm omc`, `lterm install-shim`은 tmux를 전제하는 agent 도구를 위해 가짜 `tmux` 명령과 `TMUX` / `TMUX_PANE` 환경 변수를 제공합니다.
46
+ 3. **AI 도구 지원** — `lterm agent <profile>`, `lterm claude`, `lterm codex`, `lterm opencode`, `lterm copilot`, `lterm cursor-agent`, `lterm agy`, `lterm jules`, `lterm kiro`, `lterm aider`, `lterm goose`, `lterm amp`, `lterm crush`, `lterm kimi`, `lterm qwen`, `lterm gemini`, `lterm omx`, `lterm omc`, `lterm install-shim`은 tmux를 전제하는 agent 도구를 위해 가짜 `tmux` 명령과 `TMUX` / `TMUX_PANE` 환경 변수를 제공합니다.
47
47
 
48
48
  cmux 호환 동작은 cmux가 문서화한 기능을 따릅니다. cmux는 `cmux notify`와 OSC 777 / OSC 99 알림, workspace/split을 위한 Unix socket·CLI API, 그리고 tmux 명령을 cmux native pane으로 매핑하는 tmux shim 모델을 문서화하고 있습니다.
49
49
 
@@ -64,14 +64,14 @@ npm install -g @ictechgy/lterm
64
64
  Homebrew와 npm 모두 `PATH`에 `lterm` 명령을 설치합니다. `lterm --version`으로 확인하세요.
65
65
 
66
66
  수동 설치도 귀찮다면 [`docs/agent-install.ko.md`](docs/agent-install.ko.md)의
67
- 프롬프트를 Claude Code, Codex CLI, Gemini CLI 같은 terminal coding agent에
67
+ 프롬프트를 Claude Code, Codex CLI, OpenCode, GitHub Copilot CLI, Cursor Agent, Antigravity/`agy`, Kiro, Jules, Aider, Goose, Amp, Crush, Kimi, Qwen, Gemini CLI 같은 terminal coding agent에
68
68
  붙여 넣으세요. Agent가 platform을 감지하고, `lterm`을 설치하고, smoke test로
69
69
  검증하며, shell startup file을 바꿔야 할 때는 먼저 diff를 보여주도록 안내합니다.
70
70
 
71
71
  GitHub에서 Cargo로 설치 (Releases 페이지의 최신 태그를 사용하세요):
72
72
 
73
73
  ```bash
74
- cargo install --git https://github.com/ictechgy/light_terminal --tag v1.0.2
74
+ cargo install --git https://github.com/ictechgy/light_terminal --tag v1.0.4
75
75
  ```
76
76
 
77
77
  저장소를 클론한 뒤 직접 빌드하려면 Rust 1.85 이상이 필요합니다.
@@ -142,7 +142,7 @@ lterm -a api
142
142
 
143
143
  | 작업 | 제품 명령 | 호환 경계 |
144
144
  | --- | --- | --- |
145
- | profile 기반 agent 세션 실행 | `lterm agent claude -- --help` | sibling shortcuts: `lterm claude`, `lterm codex`, `lterm gemini`, `lterm omx`, `lterm omc` |
145
+ | profile 기반 agent 세션 실행 | `lterm agent claude -- --help` | sibling shortcuts: `lterm claude`, `lterm codex`, `lterm opencode`, `lterm copilot`, `lterm cursor-agent`, `lterm agy`, `lterm jules`, `lterm kiro`, `lterm aider`, `lterm goose`, `lterm amp`, `lterm crush`, `lterm kimi`, `lterm qwen`, `lterm gemini`, `lterm omx`, `lterm omc` |
146
146
  | 사용 가능한 agent profile 확인 | `lterm agents --json` | 실행 시점의 `PATH` 사용 가능 여부 확인 |
147
147
  | `tmux` 호환 shim 설치 | `lterm install-shim` | `lterm tmux-compat`으로 전달하는 shim 생성 |
148
148
  | tmux 호환 shell export 출력 | `eval "$(lterm env)"` | shim dir을 `$PATH` 앞에 추가하는 신뢰된 `export` 행 출력 |
@@ -271,7 +271,19 @@ lterm shutdown
271
271
  ```bash
272
272
  lterm claude
273
273
  lterm codex
274
- lterm gemini -- -p "이 저장소를 요약해줘"
274
+ lterm opencode
275
+ lterm copilot
276
+ lterm cursor-agent
277
+ lterm agy -- -p "이 저장소를 요약해줘"
278
+ lterm kiro
279
+ lterm jules
280
+ lterm aider
281
+ lterm goose
282
+ lterm amp
283
+ lterm crush
284
+ lterm kimi
285
+ lterm qwen
286
+ lterm gemini -- -p "이 저장소를 요약해줘" # legacy 호환
275
287
  lterm agents
276
288
  ```
277
289
 
@@ -280,6 +292,10 @@ lterm agents
280
292
  ```bash
281
293
  lterm agent claude
282
294
  lterm agent codex
295
+ lterm agent opencode
296
+ lterm agent cursor-agent
297
+ lterm agent agy -- -p "이 저장소를 요약해줘"
298
+ lterm agent qwen
283
299
  lterm agent gemini -- -p "이 저장소를 요약해줘"
284
300
  ```
285
301
 
@@ -288,16 +304,16 @@ agent launcher는 built-in profile과 custom `lterm agent <profile>` 실행에
288
304
  ```bash
289
305
  lterm claude --name repo-review --cwd /path/to/repo
290
306
  lterm codex --detach --name repo-codex -- exec "이 저장소를 요약해줘"
291
- lterm gemini --status -- -p "lterm status를 유지해줘"
307
+ lterm agy --status -- -p "lterm status를 유지해줘"
292
308
  ```
293
309
 
294
- Claude/Codex/Gemini profile은 각 도구의 자체 TUI/status/alternate-screen 렌더링과 충돌하지 않도록 기본적으로 lterm status bar를 끈 raw full-terminal attach를 사용합니다. `--status`로 lterm status bar를 강제로 켜거나, 기본값이 켜진 profile에서는 `--no-status`로 수 있습니다. agent에 넘길 인자가 lterm launch option처럼 보일 수 있으면 앞에 `--`를 두세요. 직접 generic tmux-compatible primitive를 쓰거나 아직 profile이 없는 미래 agent 실행하려면 `lterm run -- <command>`를 사용하세요. `run`은 shim을 기본으로 켜며 `--no-tmux`로 있습니다.
310
+ Claude/Codex/OpenCode/Copilot/Cursor Agent/Antigravity/Kiro/Jules/Aider/Goose/Amp/Crush/Kimi/Qwen/Gemini profile은 각 도구의 자체 TUI/status/alternate-screen 렌더링과 충돌하지 않도록 기본적으로 lterm status bar를 끈 raw full-terminal attach를 사용합니다. OMX/OMC는 기존 lightweight status/HUD 흐름과의 연속성을 위해 lterm status bar를 기본 표시하며, 특정 OMX/OMC 실행에서 완전 raw surface가 필요하면 `--no-status`를 쓰면 됩니다. `--status`로 lterm status bar를 강제로 켜거나, status bar가 표시되는 launch/profile에서는 `--no-status`로 숨길 수 있습니다. agent에 넘길 인자가 lterm launch option처럼 보일 수 있으면 앞에 `--`를 두세요. `lterm agent <name>`은 `PATH`에서 찾을 있는 안전한 bare command name이면 바로 동작하므로, 예를 들어 `lterm agent qwen-code`처럼 미래/서드파티 agent도 쓸 수 있습니다. `lterm run -- <command>`는 낮은 수준의 tmux-compatible primitive를 직접 쓰고 싶을 때만 사용하세요.
295
311
 
296
- launcher 제어 옵션은 agent의 흔한 short flag(`-c` 등)를 빼앗지 않도록 long-only(`--name`, `--cwd`, `--detach`, `--status`, `--no-status`, `--status-theme`)입니다. 이 옵션들은 `claude`, `codex`, `gemini`, `omx`, `omc`, `agent <profile>`에 동일하게 적용됩니다. 해당 agent 세션이 이후 attach에서도 특정 lterm status 색을 유지하게 하려면 `--status-theme` / `--status-color`를 사용하세요.
312
+ launcher 제어 옵션은 agent의 흔한 short flag(`-c` 등)를 빼앗지 않도록 long-only(`--name`, `--cwd`, `--detach`, `--status`, `--no-status`, `--status-theme`)입니다. 이 옵션들은 `claude`, `codex`, `opencode`, `copilot`, `cursor-agent`, `agy`, `kiro`, `jules`, `aider`, `goose`, `amp`, `crush`, `kimi`, `qwen`, `gemini`, `omx`, `omc`, `agent <profile>`에 동일하게 적용됩니다. 해당 agent 세션이 이후 attach에서도 특정 lterm status 색을 유지하게 하려면 `--status-theme` / `--status-color`를 사용하세요.
297
313
  `--detach`는 각 field의 control character와 Unicode line/paragraph separator를 공백으로 바꾼 `name<TAB>pane<TAB>command`를 출력하며, 나중에 `lterm resume <name>` 또는 호환 이름 `lterm attach <name>`으로 다시 붙으면 됩니다. detach record에는 `--cwd`가 포함되지 않으므로 나중에 필요하면 session을 조회하세요.
298
314
  명시한 `--name`은 lterm의 일반 session-name 문법을 따르고 사용 중이지 않아야 합니다. 충돌 시 자동 suffix를 붙이지 않고 conflict error로 실패합니다.
299
315
  이름에는 ASCII 문자/숫자와 `.`, `_`, `-`만 사용할 수 있고, `-` 또는 `%`로 시작할 수 없으며, 숫자만으로 이뤄질 수 없고, UUID처럼 보이면 안 되고, 128바이트를 넘을 수 없습니다.
300
- `lterm agents` 또는 `lterm agents --json`으로 profile 기본값과 현재 `PATH`에서 binary를 찾을 수 있는지 확인할 수 있습니다. JSON row의 `kind` 값은 `built-in`, `custom`, `configured` 중 하나입니다. `lterm agents codex my-agent --json`처럼 profile 이름을 넘기면 선택한 built-in/custom/configured profile만 확인합니다. availability는 실행 시점의 PATH probe입니다.
316
+ `lterm agents` 또는 `lterm agents --json`으로 profile 기본값과 현재 `PATH`에서 binary를 찾을 수 있는지 확인할 수 있습니다. JSON row의 `kind` 값은 `built-in`, `custom`, `configured` 중 하나입니다. `lterm agents codex my-agent --json`처럼 profile 이름을 넘기면 선택한 built-in/custom/configured profile만 확인합니다. availability는 실행 시점의 PATH probe입니다. Built-in은 `lterm agents`에 표시되는 binary 이름을 그대로 `PATH`에서 찾습니다. 대부분 profile 이름과 같지만 `kiro`는 `kiro-cli`를 사용합니다. provider가 다른 command 이름으로 설치된다면 추측 alias에 의존하지 말고 `lterm agent <command>`나 configured profile을 사용하세요.
301
317
  반복해서 쓰는 custom alias는 명시적인 JSON config 파일로 넘길 수 있습니다.
302
318
 
303
319
  ```bash
package/README.md CHANGED
@@ -5,8 +5,8 @@
5
5
  ## TL;DR
6
6
 
7
7
  - **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.
8
- - **Who it's for** — Terminal-first coding agents such as Claude Code, Codex CLI, Gemini CLI, `oh-my-codex` / `oh-my-claude`, and users running them inside `cmux`.
9
- - **How** — `lterm start` to create, `lterm resume` to (re)connect, `lterm agent <profile>` / `lterm claude` / `lterm codex` / `lterm gemini` for shimmed agent runs. Inside a tmux-enabled session, the `tmux` command resolves to `lterm tmux-compat`.
8
+ - **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, `oh-my-codex` / `oh-my-claude`, and users running them inside `cmux`.
9
+ - **How** — `lterm start` to create, `lterm resume` to (re)connect, `lterm agent <profile>` / `lterm claude` / `lterm codex` / `lterm opencode` / `lterm agy` / `lterm kiro` / `lterm gemini` and other built-in shortcuts for shimmed agent runs. Inside a tmux-enabled session, the `tmux` command resolves to `lterm tmux-compat`.
10
10
  - **Status** — alpha MVP. A same-user convenience daemon — **not** a sandbox, an escape-sequence sanitizer, or a full tmux replacement.
11
11
 
12
12
  ---
@@ -26,8 +26,9 @@ need:
26
26
  - **Agent-first persistence** — named PTY sessions keep running across detached
27
27
  clients without requiring every workflow to manage a full tmux server.
28
28
  - **tmux-compatible where agents expect it** — `lterm tmux-compat` implements
29
- the command subset used by Claude Code, Codex CLI, Gemini CLI, OMX/OMC, and
30
- similar terminal-first tooling.
29
+ the command subset used by Claude Code, Codex CLI, OpenCode, GitHub Copilot
30
+ CLI, Cursor Agent, Antigravity/`agy`, Kiro, Jules, Aider, Goose, Amp,
31
+ Crush, Kimi, Qwen, Gemini CLI, OMX/OMC, and similar terminal-first tooling.
31
32
  - **Raw attach, safe reports** — attached PTY streams remain raw for TUIs and
32
33
  interactive shells, while `logs`, `capture`, `list`, `doctor`, and other
33
34
  report surfaces sanitize terminal control sequences before printing.
@@ -43,7 +44,7 @@ The project addresses three constraints:
43
44
 
44
45
  1. **tmux-like persistence and remote access** — sessions run inside a background daemon and can be attached or detached by name or pane id. Remote access is available through `lterm ssh`, provided `lterm` is installed on the remote host.
45
46
  2. **cmux compatibility** — when running inside cmux, `lterm` preserves OSC notifications, exposes `lterm notify`, and the tmux shim opens worker panes as native cmux splits when possible.
46
- 3. **AI tooling support** — `lterm agent <profile>`, `lterm claude`, `lterm codex`, `lterm gemini`, `lterm omx`, `lterm omc`, and `lterm install-shim` provide a fake `tmux` command and the `TMUX` / `TMUX_PANE` environment variables that agent tools expect.
47
+ 3. **AI tooling support** — `lterm agent <profile>`, `lterm claude`, `lterm codex`, `lterm opencode`, `lterm copilot`, `lterm cursor-agent`, `lterm agy`, `lterm jules`, `lterm kiro`, `lterm aider`, `lterm goose`, `lterm amp`, `lterm crush`, `lterm kimi`, `lterm qwen`, `lterm gemini`, `lterm omx`, `lterm omc`, and `lterm install-shim` provide a fake `tmux` command and the `TMUX` / `TMUX_PANE` environment variables that agent tools expect.
47
48
 
48
49
  cmux compatibility is grounded in cmux's documented behavior: notifications via `cmux notify` and OSC 777 / OSC 99, a Unix-socket/CLI API for workspaces and splits, and a tmux shim that maps tmux commands into native cmux panes.
49
50
 
@@ -65,7 +66,7 @@ Homebrew and npm both install the `lterm` command on your `PATH`; verify with `l
65
66
 
66
67
  Too lazy to install it manually? Copy the prompt in
67
68
  [`docs/agent-install.md`](docs/agent-install.md) into Claude Code, Codex CLI,
68
- Gemini CLI, or another terminal coding agent. It asks the agent to detect your
69
+ OpenCode, GitHub Copilot CLI, Cursor Agent, Antigravity/`agy`, Kiro, Jules, Aider, Goose, Amp, Crush, Kimi, Qwen, Gemini CLI, or another terminal coding agent. It asks the agent to detect your
69
70
  platform, install `lterm`, verify it with a smoke test, and avoid modifying
70
71
  shell startup files without showing you the change.
71
72
 
@@ -76,7 +77,7 @@ For the 1.0 command/output stability boundary, see the
76
77
  With Cargo from GitHub (use the latest tag from the Releases page):
77
78
 
78
79
  ```bash
79
- cargo install --git https://github.com/ictechgy/light_terminal --tag v1.0.2
80
+ cargo install --git https://github.com/ictechgy/light_terminal --tag v1.0.4
80
81
  ```
81
82
 
82
83
  From this checkout, use Rust 1.85 or newer:
@@ -152,7 +153,7 @@ Agent and shim utilities are also product CLI commands, not tmux aliases:
152
153
 
153
154
  | Task | Product command | Compatibility boundary |
154
155
  | --- | --- | --- |
155
- | Launch a profiled agent session | `lterm agent claude -- --help` | Sibling shortcuts: `lterm claude`, `lterm codex`, `lterm gemini`, `lterm omx`, `lterm omc` |
156
+ | Launch a profiled agent session | `lterm agent claude -- --help` | Sibling shortcuts: `lterm claude`, `lterm codex`, `lterm opencode`, `lterm copilot`, `lterm cursor-agent`, `lterm agy`, `lterm jules`, `lterm kiro`, `lterm aider`, `lterm goose`, `lterm amp`, `lterm crush`, `lterm kimi`, `lterm qwen`, `lterm gemini`, `lterm omx`, `lterm omc` |
156
157
  | Inspect available agent profiles | `lterm agents --json` | PATH availability probe at command runtime |
157
158
  | Install the `tmux` compatibility shim | `lterm install-shim` | Creates a shim that forwards to `lterm tmux-compat` |
158
159
  | Print shell exports for tmux compatibility | `eval "$(lterm env)"` (`lterm env --shell fish \| source` for fish) | Emits trusted shell setup that prepends the shim dir to `$PATH` |
@@ -281,7 +282,19 @@ lterm shutdown
281
282
  ```bash
282
283
  lterm claude
283
284
  lterm codex
284
- lterm gemini -- -p "summarize this repo"
285
+ lterm opencode
286
+ lterm copilot
287
+ lterm cursor-agent
288
+ lterm agy -- -p "summarize this repo"
289
+ lterm kiro
290
+ lterm jules
291
+ lterm aider
292
+ lterm goose
293
+ lterm amp
294
+ lterm crush
295
+ lterm kimi
296
+ lterm qwen
297
+ lterm gemini -- -p "summarize this repo" # legacy-compatible
285
298
  lterm agents
286
299
  ```
287
300
 
@@ -290,6 +303,10 @@ These are thin profile aliases for:
290
303
  ```bash
291
304
  lterm agent claude
292
305
  lterm agent codex
306
+ lterm agent opencode
307
+ lterm agent cursor-agent
308
+ lterm agent agy -- -p "summarize this repo"
309
+ lterm agent qwen
293
310
  lterm agent gemini -- -p "summarize this repo"
294
311
  ```
295
312
 
@@ -298,16 +315,16 @@ Agent launchers accept the same session controls across built-in profiles and cu
298
315
  ```bash
299
316
  lterm claude --name repo-review --cwd /path/to/repo
300
317
  lterm codex --detach --name repo-codex -- exec "summarize this repo"
301
- lterm gemini --status -- -p "keep lterm status visible"
318
+ lterm agy --status -- -p "keep lterm status visible"
302
319
  ```
303
320
 
304
- Known Claude/Codex/Gemini profiles default to a raw full-terminal attach without the lterm status bar, so their own TUI/status/alternate-screen rendering stays in control. Use `--status` to force the lterm status bar on, or `--no-status` to force it off for profiles that default on. Put `--` before agent arguments that could be parsed as lterm launch options. Use `lterm run -- <command>` when you want the generic tmux-compatible primitive directly or need to launch an unprofiled future agent; `run` enables the shim by default and `--no-tmux` opts out.
321
+ Known Claude/Codex/OpenCode/Copilot/Cursor Agent/Antigravity/Kiro/Jules/Aider/Goose/Amp/Crush/Kimi/Qwen/Gemini profiles default to a raw full-terminal attach without the lterm status bar, so their own TUI/status/alternate-screen rendering stays in control. OMX/OMC keep the lterm status bar visible by default for continuity with their existing lightweight status/HUD workflow; use `--no-status` if a specific OMX/OMC run needs a fully raw surface. Use `--status` to force the lterm status bar on, or `--no-status` to suppress it for any launch/profile that would otherwise show it. Put `--` before agent arguments that could be parsed as lterm launch options. `lterm agent <name>` also works for any safe bare command name available in `PATH` (for example `lterm agent qwen-code`); use `lterm run -- <command>` only when you want the lower-level tmux-compatible primitive directly.
305
322
 
306
- Launcher controls are long-only (`--name`, `--cwd`, `--detach`, `--status`, `--no-status`, `--status-theme`) so common agent short flags such as `-c` pass through naturally. They apply uniformly to `claude`, `codex`, `gemini`, `omx`, `omc`, and `agent <profile>`. Use `--status-theme` / `--status-color` on agent launches when you want that session to keep a specific lterm status color across future attaches.
323
+ Launcher controls are long-only (`--name`, `--cwd`, `--detach`, `--status`, `--no-status`, `--status-theme`) so common agent short flags such as `-c` pass through naturally. They apply uniformly to built-in agent shortcuts such as `claude`, `codex`, `opencode`, `copilot`, `cursor-agent`, `agy`, `kiro`, `jules`, `aider`, `goose`, `amp`, `crush`, `kimi`, `qwen`, `gemini`, `omx`, `omc`, and `agent <profile>`. Use `--status-theme` / `--status-color` on agent launches when you want that session to keep a specific lterm status color across future attaches.
307
324
  `--detach` prints `name<TAB>pane<TAB>command` with control characters and Unicode line/paragraph separators in each field replaced by spaces; resume later with `lterm resume <name>` or compatibility name `lterm attach <name>`. The detach record does not echo `--cwd`; query the session if you need to inspect it later.
308
325
  Explicit `--name` values use lterm's normal session-name syntax and must be free; they do not auto-suffix on conflict, so an in-use name fails with a conflict error.
309
326
  Names may contain ASCII letters, digits, `.`, `_`, and `-`, must not start with `-` or `%`, must not consist only of digits, must not look like a UUID, and are limited to 128 bytes.
310
- Use `lterm agents` (or `lterm agents --json`) to inspect profile defaults and whether their binaries are currently available in `PATH`. JSON rows use `kind` values of `built-in`, `custom`, or `configured`. Pass profile names, such as `lterm agents codex my-agent --json`, to inspect a selected built-in/custom/configured set; availability is a point-in-time PATH probe.
327
+ Use `lterm agents` (or `lterm agents --json`) to inspect profile defaults and whether their binaries are currently available in `PATH`. JSON rows use `kind` values of `built-in`, `custom`, or `configured`. Pass profile names, such as `lterm agents codex my-agent --json`, to inspect a selected built-in/custom/configured set; availability is a point-in-time PATH probe. Built-ins resolve the binary names shown by `lterm agents`; most match the profile name, while `kiro` resolves `kiro-cli`. If a provider installs a different command name, use `lterm agent <command>` or a configured profile rather than relying on a guessed alias.
311
328
  For reusable custom aliases, pass an explicit JSON config file:
312
329
 
313
330
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ictechgy/lterm",
3
- "version": "1.0.2",
3
+ "version": "1.0.4",
4
4
  "description": "Lightweight tmux-compatible terminal session daemon with cmux-friendly notifications.",
5
5
  "license": "MIT OR Apache-2.0",
6
6
  "homepage": "https://github.com/ictechgy/light_terminal#readme",
@@ -31,10 +31,10 @@
31
31
  "LICENSE-MIT"
32
32
  ],
33
33
  "optionalDependencies": {
34
- "lterm-darwin-arm64": "1.0.2",
35
- "lterm-darwin-x64": "1.0.2",
36
- "lterm-linux-arm64": "1.0.2",
37
- "lterm-linux-x64": "1.0.2"
34
+ "lterm-darwin-arm64": "1.0.4",
35
+ "lterm-darwin-x64": "1.0.4",
36
+ "lterm-linux-arm64": "1.0.4",
37
+ "lterm-linux-x64": "1.0.4"
38
38
  },
39
39
  "engines": {
40
40
  "node": ">=16"