projmux 0.14.2 → 0.15.0

package/README-ko.md

@@ -5,9 +5,9 @@
 </p>
 
 <p align="center">
-  <strong>여러 AI 에이전트를 함께 쓰는 tmux 기반 개발 작업 공간.</strong>
+  <strong>여러 AI 에이전트로 개발하기 위한 tmux 작업 공간.</strong>
   <br>
-  <em>Claude Code, Codex, Antigravity pane을 한곳에서 운영하고, 에이전트가 권한을 요청하거나 작업을 마치면 바로 알려 줍니다.</em>
+  <em>Codex, Claude Code, Antigravity를 한 작업 공간에 나란히 띄웁니다.</em>
 </p>
 
 <p align="center">
@@ -17,140 +17,84 @@
   <a href="README.md"><img src="https://img.shields.io/badge/lang-English-blue" alt="English README"></a>
 </p>
 
+```sh
+npm install -g projmux
+projmux shell
+```
+
 <p align="center">
-  <img src="docs/assets/projmux-ai-attention.gif" alt="projmux의 AI 세션 재개, 권한 요청, 그룹형 알림 흐름" width="820">
-  <br>
-  <em>기존 AI 세션을 이어서 열고 다른 프로젝트에서 작업하다가, 에이전트가 승인을 요청하면 그룹형 알림에서 확인하고 해당 작업 pane으로 돌아갑니다.</em>
+  <img src="docs/assets/projmux-overview-ko.gif" alt="projmux 작업 공간: 프로젝트를 옮기고, 이어서 열 세션을 고르고, 실행 중인 에이전트 옆에서 대화를 이어갑니다" width="820">
 </p>
 
-## projmux란?
+## 키
 
-`projmux`는 프로젝트 디렉터리마다 오래 유지되는 tmux 세션을 연결합니다.
-프로젝트 전환, 세션 미리보기, AI 분할 창 실행, 상태 표시를 키보드 중심의
-작업 공간 하나로 묶습니다.
-Claude Code, Codex, Antigravity의 훅 연동을 관리하고, 각 에이전트의 권한
-요청과 작업 완료 알림을 한곳에 모읍니다.
+- `Alt-1` 프로젝트
+- `Alt-2` 알림
+- `Alt-3` 최근 창
+- `Alt-4` AI 재개
+- `Alt-5` 설정
+- `Alt-7` AI 실행 (pane 분할)
 
-터미널 작업 공간을 명령 하나로 열고, 같은 키 조합으로 프로젝트와 tmux
-창, pane, 알림, 설정 사이를 빠르게 오가고 싶을 때 사용합니다.
+`Alt-1`–`Alt-5`는 설정 없이 바로 동작합니다. 키를 바꾸려면
+[터미널 키 설정](docs/keybindings.md)을 보세요.
 
-## 요구 사항
-
-- [Node.js](https://nodejs.org/)와 npm: 기본 설치 경로에 필요합니다.
-- [tmux](https://github.com/tmux/tmux/wiki/Installing) **3.4 이상**.
-
-설치한 뒤에는 읽기 전용 점검 명령인 `projmux doctor`로 로컬 실행 환경을
-확인하세요.
+## 하던 대화 이어가기
 
-## 설치
+`Alt-4`를 누르면 Codex, Claude Code, Antigravity 세션이 한 곳에 모여 나옵니다.
+하나를 고르면 하던 자리에서, 같은 대화 그대로 열립니다.
 
-```sh
-npm install -g projmux
-projmux version
-```
+## 에이전트가 부를 때
 
-npm 패키지는 작은 Node.js 실행 연결부와 Linux/macOS x64·arm64용 projmux
-실행 파일을 함께 설치합니다. 일반 사용자에게는 npm 설치를 권장합니다.
+승인 요청이든 작업 완료든, 에이전트가 보내는 알림은 한 곳에 모입니다. `Alt-2`를
+누르면 기다리고 있는 pane으로 바로 갑니다.
 
-Go 또는 소스 코드로 직접 설치하는 방법, GitHub Release와 패키징에 관한
-내용은 [설치 안내](docs/install.md)를 참고하세요.
+<p align="center">
+  <img src="docs/assets/projmux-ai-attention-ko.gif" alt="projmux 알림함: 대화 도중 알림이 도착하면 그 알림을 낸 pane으로 바로 이동합니다" width="820">
+</p>
 
-## 빠른 시작
+## 여러 에이전트를 나란히
 
-독립된 projmux용 tmux 환경을 엽니다.
+창 하나에 shell, Codex, Claude Code를 함께 띄워 둘 수 있습니다. 에이전트가 다른
+에이전트를 열 때도 사람이 쓰는 것과 같은 CLI를 씁니다.
 
 ```sh
-projmux shell
+projmux create claude --project mobile-client -- "마이그레이션 계획 초안을 잡아줘."
 ```
 
-projmux 안에서는 다음 키를 사용합니다.
-
-- `Alt-1`: 프로젝트 사이드바를 엽니다.
-- `Alt-2`: 알림 목록을 엽니다.
-- `Alt-3`: 최근 창 목록(`Recent Windows`)을 엽니다.
-- `Alt-4`: 이어서 열 AI 세션을 선택합니다.
-- `Alt-5`: 설정을 엽니다.
-- `Alt-7`: 새 AI 분할 창을 선택합니다.
-
-`Alt-1`부터 `Alt-5`까지는 별도 설정 없이 쓸 수 있는 기본 키입니다. `Alt-7`도
-기본으로 제공되며 설정에서 바꿀 수 있습니다. 전체 키 구성은
-[터미널 키 설정](docs/keybindings.md)을 참고하세요.
-
-키가 동작하지 않는다면 macOS 배포본의 `projmux shell`에서는 접근성 권한을
-한 번 승인하세요. 이후 물리 키 어댑터가 자동으로 동작합니다. 그 밖의
-환경에서는 tmux 밖에서 `projmux setup`을 실행한 다음, 지원되는 터미널에
-`projmux setup terminal [terminal] --apply`를 적용하세요.
-
-## 일상 사용
-
-- 프로젝트 디렉터리를 고르면 projmux가 해당 tmux 세션을 만들거나 기존
-  세션을 다시 사용합니다.
-- 자주 쓰는 프로젝트는 `pin`으로 고정해 목록 위쪽에서 쉽게 찾을 수
-  있습니다.
-- 전환하기 전에 창(window)과 pane, Git 브랜치, AI pane
-  상태를 미리 확인할 수 있습니다.
-- 기존 Claude, Codex, Antigravity 대화를 이어서 열거나 projmux가 관리하는 새
-  AI 분할 창을 만들 수 있습니다.
-- 권한 요청과 작업 완료 알림을 에이전트별로 묶어 보고, 확인이 필요한
-  pane으로 곧바로 이동할 수 있습니다.
-- 읽기 전용 `Resource Inspector`에서 프로젝트, 창, pane별 CPU와 RSS 사용량을
-  확인할 수 있습니다. 현재 Linux/tmux 환경을 지원합니다.
-- 창과 pane 배치, shell 작업 디렉터리, 지원되는 AI 세션 재개 정보를
-  `Session State` 스냅샷으로 저장하고 미리 볼 수 있습니다.
-- 환경 변수를 직접 편집하지 않고 `Settings > Project Picker`에서 검색 루트와
-  작업 디렉터리를 추가할 수 있습니다.
-- `Settings > About > Update` 또는 `projmux update apply`로 업그레이드할 수
-  있습니다.
-
 <p align="center">
-  <img src="docs/assets/projmux-shell-sidebar.gif" alt="projmux의 프로젝트 전환과 Codex 작업 흐름" width="820">
-  <br>
-  <em>프로젝트를 전환하고 Codex pane을 연 뒤 완료 알림을 확인합니다.</em>
+  <img src="docs/assets/projmux-three-pane-workflow-ko.gif" alt="projmux 3-pane 작업 흐름: shell, Codex, 그리고 Codex가 연 Claude Code pane" width="820">
 </p>
 
-`PROJMUX_PROJDIR`, 관리 루트, 알림, 사용량 추적에 관한 자세한 내용은
-[설정](docs/configuration.md)을 참고하세요. 설치 방식에 따른 업데이트 동작은
-[업그레이드 안내](docs/upgrading.md)에 정리되어 있습니다.
-
-## 멀티 에이전트 워크플로
+에이전트별 템플릿과 이름 규칙은
+[AI 에이전트 바로가기](docs/ai-agent-shortcuts.md)에 정리해 두었습니다.
 
-하나의 tmux 창에 shell과 projmux가 관리하는 Claude, Codex, Antigravity pane을
-나란히 띄울 수 있습니다. 프로젝트와 pane 사이를 오가며 작업해도 projmux가
-에이전트별 권한 요청과 완료 알림을 그룹형 알림함에 모아 줍니다.
+## 그 밖에
 
-<p align="center">
-  <img src="docs/assets/projmux-three-pane-workflow.gif" alt="projmux의 shell, Codex, Claude 3-pane 작업 흐름" width="820">
-  <br>
-  <em>shell, Codex, Claude pane을 오가며 서로 다른 작업을 진행하고, 완료 알림은 한곳에서 확인합니다.</em>
-</p>
+- [Resource Inspector](docs/resource-attribution.md) — 프로젝트·창·pane별 CPU와
+  RSS를 실시간으로 봅니다.
+- [Session State](docs/session-restore.md) — 창 배치와 작업 디렉터리를 스냅샷으로
+  남깁니다.
+- 검색 루트, 키 설정, 업데이트는 설정에서 바꿉니다.
 
-## 에이전트 스킬 자동화
+## 요구 사항
 
-AI 도구에서도 같은 projmux 명령줄 도구(CLI)를 호출해 projmux가 관리하는
-pane을 열고 작업 지시를 전달할 수 있습니다.
+[Node.js](https://nodejs.org/)와 npm,
+[tmux](https://github.com/tmux/tmux/wiki/Installing) 3.4 이상이 필요합니다.
+로컬 환경은 `projmux doctor`로 점검합니다. 읽기만 하고 아무것도 바꾸지 않습니다.
+앱이 아예 뜨지 않으면 [문제 해결](docs/troubleshooting.md)을 보세요.
 
-```sh
-projmux create codex --placement right -- "Review the retry logic."
-```
+## 문서
 
-Claude, Codex를 비롯한 여러 에이전트용 템플릿과 이름 규칙은
-[AI 에이전트 바로가기](docs/ai-agent-shortcuts.md)에 정리되어 있습니다.
-
-## 추가 문서
-
-- [설치 안내](docs/install.md)
-- [설정](docs/configuration.md)
-- [터미널 키 설정](docs/keybindings.md)
-- [AI 에이전트 바로가기](docs/ai-agent-shortcuts.md)
-- [CLI 명령어](docs/cli.md) — 커맨드 매니페스트에서 생성됨
-- [CLI 사용 가이드](docs/cli-guide.md)
-- [상태 표시줄](docs/statusbar.md)
-- [훅](docs/hooks.md)
-- [사용량 추적](docs/usage-tracking.md)
-- [Resource Inspector](docs/resource-attribution.md)
-- [Session State](docs/session-restore.md)
-- [운영 진단](docs/operational-diagnostics.md)
-- [에이전트 작업 흐름](docs/agent-workflow.md)
+[설치 안내](docs/install.md) ·
+[설정](docs/configuration.md) ·
+[업그레이드](docs/upgrading.md) ·
+[CLI 명령어](docs/cli.md) ·
+[CLI 사용 가이드](docs/cli-guide.md) ·
+[상태 표시줄](docs/statusbar.md) ·
+[훅](docs/hooks.md) ·
+[사용량 추적](docs/usage-tracking.md) ·
+[운영 진단](docs/operational-diagnostics.md) ·
+[에이전트 작업 흐름](docs/agent-workflow.md)
 
 ## 개발
 
@@ -161,9 +105,9 @@ make fix
 make test
 ```
 
-기여자를 위한 자세한 내용은 [테스트](docs/testing.md),
-[구조](docs/architecture.md), [저장소 구성](docs/repo-layout.md)을 참고하세요.
+자세한 내용은 [테스트](docs/testing.md), [구조](docs/architecture.md),
+[저장소 구성](docs/repo-layout.md)에 있습니다.
 
 ## 라이선스
 
-MIT. [LICENSE](LICENSE)를 참고하세요.
+MIT. [LICENSE](LICENSE)를 보세요.

package/README.md

@@ -7,7 +7,7 @@
 <p align="center">
   <strong>A tmux-native workspace for multi-agent AI development.</strong>
   <br>
-  <em>Managed Claude Code, Codex, and Antigravity panes with hook-driven attention and agent-aware session resume.</em>
+  <em>Run Codex, Claude Code, and Antigravity side by side in one workspace.</em>
 </p>
 
 <p align="center">
@@ -23,138 +23,77 @@ projmux shell
 ```
 
 <p align="center">
-  <img src="docs/assets/projmux-ai-attention.gif" alt="projmux AI session resume, agent permission, and grouped notification workflow" width="820">
-  <br>
-  <em>Resume an existing AI session, keep working in another project, then return through grouped notifications when the agent needs approval.</em>
+  <img src="docs/assets/projmux-overview.gif" alt="projmux workspace: switch projects, pick a session to resume, and continue it next to a running agent" width="820">
 </p>
 
-## Why
-
-Six tmux windows. Each one is running Claude Code, Codex, or Antigravity on a
-different repo. Three are idle. One is waiting on a permission prompt. One
-crashed an hour ago and you have no idea which.
+## Keys
 
-projmux manages Claude Code, Codex, and Antigravity hook integrations, including
-Antigravity's hook/statusline wiring, shows live per-pane state in the tmux
-status bar, and lets one keystroke take you to the pane that actually needs
-you. It also remembers each agent's resume id, so after a reboot every pane
-comes back as the *same* conversation — not a fresh one.
+- `Alt-1` projects
+- `Alt-2` notifications
+- `Alt-3` recent windows
+- `Alt-4` resume an AI session
+- `Alt-5` settings
+- `Alt-7` new AI split
 
-## Requirements
+`Alt-1`–`Alt-5` work with no configuration. See
+[Terminal Keybindings](docs/keybindings.md) to remap them.
 
-- [Node.js](https://nodejs.org/) and npm, for the main install path.
-- [tmux](https://github.com/tmux/tmux/wiki/Installing) **3.4 or newer**.
+## Pick up a conversation
 
-Run `projmux doctor` after installing for read-only local runtime diagnostics.
+`Alt-4` lists your Codex, Claude Code, and Antigravity sessions. Choose one and
+it opens where you left it, as the same conversation.
 
-## Install
+## Get called back
 
-The npm package shown above installs a small Node.js shim plus the matching
-projmux binary for Linux and macOS on x64 or arm64. npm is the primary
-distribution path for normal users.
+Agent permission requests and completions land in one grouped inbox. `Alt-2`
+takes you to the pane that is waiting.
 
-Verify with `projmux version`. Then `projmux doctor` provides read-only local
-runtime diagnostics (tmux 3.4+ and hook integration health).
-If installation succeeds but the app cannot enter or npm reports an incomplete
-optional dependency, follow [Troubleshooting](docs/troubleshooting.md).
-
-Manual Go, source checkout, GitHub Release, and packaging details live in
-[Install](docs/install.md).
+<p align="center">
+  <img src="docs/assets/projmux-ai-attention.gif" alt="projmux attention queue: a notification lands mid-conversation, and one key takes you to the pane that raised it" width="820">
+</p>
 
-## Quick Start
+## Run agents in parallel
 
-Open the isolated projmux tmux app:
+Keep a shell, Codex, and Claude Code in the same window. Agents can open other
+agents through the same CLI you use:
 
 ```sh
-projmux shell
+projmux create claude --project mobile-client -- "Draft the migration plan."
 ```
 
-Inside the app:
-
-- `Alt-1` opens the project sidebar.
-- `Alt-2` opens the notification list.
-- `Alt-3` opens Recent Windows.
-- `Alt-4` opens the AI resume session picker.
-- `Alt-5` opens settings.
-- `Alt-7` opens the AI split picker.
-
-The `Alt-1` through `Alt-5` launch keys are the guaranteed zero-config
-defaults. `Alt-7` is an additional editable built-in default. Add aliases in
-Settings > Keybindings or `~/.config/projmux/keymap.toml`. If a key does not
-fire, the Darwin release uses a native physical-key adapter automatically
-inside `projmux shell` after one-time macOS Accessibility approval. On other
-paths, run `projmux setup` outside tmux, then use
-`projmux setup terminal [terminal] --apply` for supported terminal delivery
-fallbacks.
-
-## Day-To-Day Use
-
-- Pick a project directory and projmux creates or reuses its tmux session.
-- Pin important projects so they stay easy to reach.
-- Preview windows, panes, git branch, and AI pane state
-  before switching.
-- Resume an existing Claude, Codex, or Antigravity conversation, or open a new
-  managed AI split.
-- Review grouped permission and completion events, then jump directly to the
-  pane that needs attention.
-- Inspect live project, window, and pane CPU/RSS with the read-only Resource
-  Inspector on Linux/tmux.
-- Save and inspect Session State snapshots for window/pane layouts, shell cwd,
-  and supported AI resumes.
-- Use Settings > Project Picker to add roots and workdirs without editing env
-  vars.
-- Use Settings > About > Update or `projmux update apply` to upgrade.
-
 <p align="center">
-  <img src="docs/assets/projmux-shell-sidebar.gif" alt="projmux project switch and managed Codex workflow" width="820">
-  <br>
-  <em>Switch projects, launch a managed Codex pane, and review its completion notification.</em>
+  <img src="docs/assets/projmux-three-pane-workflow.gif" alt="projmux three-pane workflow: a shell, Codex, and a Claude Code pane Codex opened" width="820">
 </p>
 
-For detailed configuration, including `PROJMUX_PROJDIR`, managed roots,
-notifications, and usage tracking, see [Configuration](docs/configuration.md).
-For update behavior by installer type, see [Upgrading](docs/upgrading.md).
-
-## Multi-Agent Workflow
-
-Keep a shell and managed Claude, Codex, or Antigravity panes visible in the
-same tmux window. Move between projects and panes while projmux collects agent
-permission and completion events in one grouped inbox.
+Templates and naming conventions are in
+[AI Agent Shortcuts](docs/ai-agent-shortcuts.md).
 
-<p align="center">
-  <img src="docs/assets/projmux-three-pane-workflow.gif" alt="projmux shell, Codex, and Claude three-pane workflow" width="820">
-  <br>
-  <em>Move across shell, Codex, and Claude panes while independent tasks report back through one notification queue.</em>
-</p>
+## Also in the app
 
-## Automation With Agent Skills
+- Live per-project, per-window, and per-pane CPU/RSS in the
+  [Resource Inspector](docs/resource-attribution.md).
+- Layout and cwd snapshots in [Session State](docs/session-restore.md).
+- Search roots, keybindings, and updates in Settings.
 
-AI tools can invoke the same projmux CLI to open a managed pane and deliver a
-prompt:
+## Requirements
 
-```sh
-projmux create codex --placement right -- "Review the retry logic."
-```
+[Node.js](https://nodejs.org/) and npm, plus
+[tmux](https://github.com/tmux/tmux/wiki/Installing) 3.4 or newer. Run
+`projmux doctor` for read-only local diagnostics, or
+[Troubleshooting](docs/troubleshooting.md) if the app will not start.
 
-Templates and naming conventions for Claude, Codex, and other agents are in
-[AI Agent Shortcuts](docs/ai-agent-shortcuts.md).
+## Docs
 
-## More Docs
-
-- [Install](docs/install.md)
-- [Configuration](docs/configuration.md)
-- [Terminal Keybindings](docs/keybindings.md)
-- [AI Agent Shortcuts](docs/ai-agent-shortcuts.md)
-- [CLI Reference](docs/cli.md) — generated from the command manifest
-- [CLI Task Guide](docs/cli-guide.md)
-- [Statusbar](docs/statusbar.md)
-- [Hooks](docs/hooks.md)
-- [Usage tracking](docs/usage-tracking.md)
-- [Resource Inspector](docs/resource-attribution.md)
-- [Session State](docs/session-restore.md)
-- [Operational Diagnostics](docs/operational-diagnostics.md)
-- [Troubleshooting](docs/troubleshooting.md)
-- [Agent Workflow](docs/agent-workflow.md)
+[Install](docs/install.md) ·
+[Configuration](docs/configuration.md) ·
+[Upgrading](docs/upgrading.md) ·
+[CLI Reference](docs/cli.md) ·
+[CLI Task Guide](docs/cli-guide.md) ·
+[Statusbar](docs/statusbar.md) ·
+[Hooks](docs/hooks.md) ·
+[Usage tracking](docs/usage-tracking.md) ·
+[Operational Diagnostics](docs/operational-diagnostics.md) ·
+[Agent Workflow](docs/agent-workflow.md)
 
 ## Development
 
@@ -166,7 +105,7 @@ make test
 ```
 
 See [Testing](docs/testing.md), [Architecture](docs/architecture.md), and
-[Repo Layout](docs/repo-layout.md) for contributor details.
+[Repo Layout](docs/repo-layout.md).
 
 ## License