@projmux/darwin-arm64 0.14.2 → 0.15.0-rc.1

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.md +49 -110
  2. package/bin/projmux +0 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
  <p align="center">
8
8
  <strong>A tmux-native workspace for multi-agent AI development.</strong>
9
9
  <br>
10
- <em>Managed Claude Code, Codex, and Antigravity panes with hook-driven attention and agent-aware session resume.</em>
10
+ <em>Run Codex, Claude Code, and Antigravity side by side in one workspace.</em>
11
11
  </p>
12
12
 
13
13
  <p align="center">
@@ -23,138 +23,77 @@ projmux shell
23
23
  ```
24
24
 
25
25
  <p align="center">
26
- <img src="docs/assets/projmux-ai-attention.gif" alt="projmux AI session resume, agent permission, and grouped notification workflow" width="820">
27
- <br>
28
- <em>Resume an existing AI session, keep working in another project, then return through grouped notifications when the agent needs approval.</em>
26
+ <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">
29
27
  </p>
30
28
 
31
- ## Why
32
-
33
- Six tmux windows. Each one is running Claude Code, Codex, or Antigravity on a
34
- different repo. Three are idle. One is waiting on a permission prompt. One
35
- crashed an hour ago and you have no idea which.
29
+ ## Keys
36
30
 
37
- projmux manages Claude Code, Codex, and Antigravity hook integrations, including
38
- Antigravity's hook/statusline wiring, shows live per-pane state in the tmux
39
- status bar, and lets one keystroke take you to the pane that actually needs
40
- you. It also remembers each agent's resume id, so after a reboot every pane
41
- comes back as the *same* conversation — not a fresh one.
31
+ - `Alt-1` projects
32
+ - `Alt-2` notifications
33
+ - `Alt-3` recent windows
34
+ - `Alt-4` resume an AI session
35
+ - `Alt-5` settings
36
+ - `Alt-7` new AI split
42
37
 
43
- ## Requirements
38
+ `Alt-1`–`Alt-5` work with no configuration. See
39
+ [Terminal Keybindings](docs/keybindings.md) to remap them.
44
40
 
45
- - [Node.js](https://nodejs.org/) and npm, for the main install path.
46
- - [tmux](https://github.com/tmux/tmux/wiki/Installing) **3.4 or newer**.
41
+ ## Pick up a conversation
47
42
 
48
- Run `projmux doctor` after installing for read-only local runtime diagnostics.
43
+ `Alt-4` lists your Codex, Claude Code, and Antigravity sessions. Choose one and
44
+ it opens where you left it, as the same conversation.
49
45
 
50
- ## Install
46
+ ## Get called back
51
47
 
52
- The npm package shown above installs a small Node.js shim plus the matching
53
- projmux binary for Linux and macOS on x64 or arm64. npm is the primary
54
- distribution path for normal users.
48
+ Agent permission requests and completions land in one grouped inbox. `Alt-2`
49
+ takes you to the pane that is waiting.
55
50
 
56
- Verify with `projmux version`. Then `projmux doctor` provides read-only local
57
- runtime diagnostics (tmux 3.4+ and hook integration health).
58
- If installation succeeds but the app cannot enter or npm reports an incomplete
59
- optional dependency, follow [Troubleshooting](docs/troubleshooting.md).
60
-
61
- Manual Go, source checkout, GitHub Release, and packaging details live in
62
- [Install](docs/install.md).
51
+ <p align="center">
52
+ <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">
53
+ </p>
63
54
 
64
- ## Quick Start
55
+ ## Run agents in parallel
65
56
 
66
- Open the isolated projmux tmux app:
57
+ Keep a shell, Codex, and Claude Code in the same window. Agents can open other
58
+ agents through the same CLI you use:
67
59
 
68
60
  ```sh
69
- projmux shell
61
+ projmux create claude --project mobile-client -- "Draft the migration plan."
70
62
  ```
71
63
 
72
- Inside the app:
73
-
74
- - `Alt-1` opens the project sidebar.
75
- - `Alt-2` opens the notification list.
76
- - `Alt-3` opens Recent Windows.
77
- - `Alt-4` opens the AI resume session picker.
78
- - `Alt-5` opens settings.
79
- - `Alt-7` opens the AI split picker.
80
-
81
- The `Alt-1` through `Alt-5` launch keys are the guaranteed zero-config
82
- defaults. `Alt-7` is an additional editable built-in default. Add aliases in
83
- Settings > Keybindings or `~/.config/projmux/keymap.toml`. If a key does not
84
- fire, the Darwin release uses a native physical-key adapter automatically
85
- inside `projmux shell` after one-time macOS Accessibility approval. On other
86
- paths, run `projmux setup` outside tmux, then use
87
- `projmux setup terminal [terminal] --apply` for supported terminal delivery
88
- fallbacks.
89
-
90
- ## Day-To-Day Use
91
-
92
- - Pick a project directory and projmux creates or reuses its tmux session.
93
- - Pin important projects so they stay easy to reach.
94
- - Preview windows, panes, git branch, and AI pane state
95
- before switching.
96
- - Resume an existing Claude, Codex, or Antigravity conversation, or open a new
97
- managed AI split.
98
- - Review grouped permission and completion events, then jump directly to the
99
- pane that needs attention.
100
- - Inspect live project, window, and pane CPU/RSS with the read-only Resource
101
- Inspector on Linux/tmux.
102
- - Save and inspect Session State snapshots for window/pane layouts, shell cwd,
103
- and supported AI resumes.
104
- - Use Settings > Project Picker to add roots and workdirs without editing env
105
- vars.
106
- - Use Settings > About > Update or `projmux update apply` to upgrade.
107
-
108
64
  <p align="center">
109
- <img src="docs/assets/projmux-shell-sidebar.gif" alt="projmux project switch and managed Codex workflow" width="820">
110
- <br>
111
- <em>Switch projects, launch a managed Codex pane, and review its completion notification.</em>
65
+ <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">
112
66
  </p>
113
67
 
114
- For detailed configuration, including `PROJMUX_PROJDIR`, managed roots,
115
- notifications, and usage tracking, see [Configuration](docs/configuration.md).
116
- For update behavior by installer type, see [Upgrading](docs/upgrading.md).
117
-
118
- ## Multi-Agent Workflow
119
-
120
- Keep a shell and managed Claude, Codex, or Antigravity panes visible in the
121
- same tmux window. Move between projects and panes while projmux collects agent
122
- permission and completion events in one grouped inbox.
68
+ Templates and naming conventions are in
69
+ [AI Agent Shortcuts](docs/ai-agent-shortcuts.md).
123
70
 
124
- <p align="center">
125
- <img src="docs/assets/projmux-three-pane-workflow.gif" alt="projmux shell, Codex, and Claude three-pane workflow" width="820">
126
- <br>
127
- <em>Move across shell, Codex, and Claude panes while independent tasks report back through one notification queue.</em>
128
- </p>
71
+ ## Also in the app
129
72
 
130
- ## Automation With Agent Skills
73
+ - Live per-project, per-window, and per-pane CPU/RSS in the
74
+ [Resource Inspector](docs/resource-attribution.md).
75
+ - Layout and cwd snapshots in [Session State](docs/session-restore.md).
76
+ - Search roots, keybindings, and updates in Settings.
131
77
 
132
- AI tools can invoke the same projmux CLI to open a managed pane and deliver a
133
- prompt:
78
+ ## Requirements
134
79
 
135
- ```sh
136
- projmux create codex --placement right -- "Review the retry logic."
137
- ```
80
+ [Node.js](https://nodejs.org/) and npm, plus
81
+ [tmux](https://github.com/tmux/tmux/wiki/Installing) 3.4 or newer. Run
82
+ `projmux doctor` for read-only local diagnostics, or
83
+ [Troubleshooting](docs/troubleshooting.md) if the app will not start.
138
84
 
139
- Templates and naming conventions for Claude, Codex, and other agents are in
140
- [AI Agent Shortcuts](docs/ai-agent-shortcuts.md).
85
+ ## Docs
141
86
 
142
- ## More Docs
143
-
144
- - [Install](docs/install.md)
145
- - [Configuration](docs/configuration.md)
146
- - [Terminal Keybindings](docs/keybindings.md)
147
- - [AI Agent Shortcuts](docs/ai-agent-shortcuts.md)
148
- - [CLI Reference](docs/cli.md) — generated from the command manifest
149
- - [CLI Task Guide](docs/cli-guide.md)
150
- - [Statusbar](docs/statusbar.md)
151
- - [Hooks](docs/hooks.md)
152
- - [Usage tracking](docs/usage-tracking.md)
153
- - [Resource Inspector](docs/resource-attribution.md)
154
- - [Session State](docs/session-restore.md)
155
- - [Operational Diagnostics](docs/operational-diagnostics.md)
156
- - [Troubleshooting](docs/troubleshooting.md)
157
- - [Agent Workflow](docs/agent-workflow.md)
87
+ [Install](docs/install.md) ·
88
+ [Configuration](docs/configuration.md) ·
89
+ [Upgrading](docs/upgrading.md) ·
90
+ [CLI Reference](docs/cli.md) ·
91
+ [CLI Task Guide](docs/cli-guide.md) ·
92
+ [Statusbar](docs/statusbar.md) ·
93
+ [Hooks](docs/hooks.md) ·
94
+ [Usage tracking](docs/usage-tracking.md) ·
95
+ [Operational Diagnostics](docs/operational-diagnostics.md) ·
96
+ [Agent Workflow](docs/agent-workflow.md)
158
97
 
159
98
  ## Development
160
99
 
@@ -166,7 +105,7 @@ make test
166
105
  ```
167
106
 
168
107
  See [Testing](docs/testing.md), [Architecture](docs/architecture.md), and
169
- [Repo Layout](docs/repo-layout.md) for contributor details.
108
+ [Repo Layout](docs/repo-layout.md).
170
109
 
171
110
  ## License
172
111
 
package/bin/projmux CHANGED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@projmux/darwin-arm64",
3
- "version": "0.14.2",
3
+ "version": "0.15.0-rc.1",
4
4
  "description": "macOS arm64 binary for projmux",
5
5
  "license": "MIT",
6
6
  "repository": {