@projmux/darwin-x64 0.7.3 → 0.7.5
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.
- package/README.md +34 -29
- package/bin/projmux +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -25,7 +25,7 @@ projmux shell
|
|
|
25
25
|
<p align="center">
|
|
26
26
|
<img src="docs/assets/projmux-ai-attention.gif" alt="projmux AI attention demo" width="820">
|
|
27
27
|
<br>
|
|
28
|
-
<em>
|
|
28
|
+
<em>Resume an existing AI session, keep working in another project, then jump back when the managed pane needs permission.</em>
|
|
29
29
|
</p>
|
|
30
30
|
|
|
31
31
|
## Why
|
|
@@ -72,15 +72,15 @@ Inside the app:
|
|
|
72
72
|
- `Alt-1` opens the project sidebar.
|
|
73
73
|
- `Alt-2` opens the notification list.
|
|
74
74
|
- `Alt-3` opens Recent Windows.
|
|
75
|
-
- `Alt-4` opens the AI
|
|
75
|
+
- `Alt-4` opens the AI resume session picker.
|
|
76
76
|
- `Alt-5` opens settings.
|
|
77
|
-
- `Alt-7` opens the AI
|
|
77
|
+
- `Alt-7` opens the AI split picker.
|
|
78
78
|
|
|
79
79
|
The `Alt-1` through `Alt-5` launch keys are the guaranteed zero-config
|
|
80
|
-
defaults. Add
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
80
|
+
defaults. `Alt-7` is an additional editable built-in default. Add aliases in
|
|
81
|
+
Settings > Keybindings or `~/.config/projmux/keymap.toml`. If a key does not
|
|
82
|
+
fire, run `projmux setup` outside tmux, then use `projmux init [terminal]
|
|
83
|
+
--apply` for supported terminal delivery fallbacks.
|
|
84
84
|
|
|
85
85
|
## Day-To-Day Use
|
|
86
86
|
|
|
@@ -88,43 +88,48 @@ does not fire, run `projmux setup` outside tmux, then use
|
|
|
88
88
|
- Pin important projects so they stay easy to reach.
|
|
89
89
|
- Preview windows, panes, git branch, Kubernetes context, and AI pane state
|
|
90
90
|
before switching.
|
|
91
|
+
- Resume an existing Claude or Codex conversation, or open a new managed AI
|
|
92
|
+
split.
|
|
93
|
+
- Review permission and completion events in one notification queue, then jump
|
|
94
|
+
directly to the pane that needs attention.
|
|
91
95
|
- Use Settings > Project Picker to add roots and workdirs without editing env
|
|
92
96
|
vars.
|
|
93
97
|
- Use Settings > About > Update or `projmux update apply` to upgrade.
|
|
94
98
|
|
|
99
|
+
<p align="center">
|
|
100
|
+
<img src="docs/assets/projmux-shell-sidebar.gif" alt="projmux project switch and managed Codex demo" width="820">
|
|
101
|
+
<br>
|
|
102
|
+
<em>Switch projects, launch a managed Codex pane, and review its completion notification.</em>
|
|
103
|
+
</p>
|
|
104
|
+
|
|
95
105
|
For detailed configuration, including `PROJMUX_PROJDIR`, managed roots,
|
|
96
106
|
notifications, and usage tracking, see [Configuration](docs/configuration.md).
|
|
97
107
|
For update behavior by installer type, see [Upgrading](docs/upgrading.md).
|
|
98
108
|
|
|
99
|
-
## Agent
|
|
109
|
+
## Multi-Agent Workflow
|
|
100
110
|
|
|
101
|
-
|
|
102
|
-
|
|
111
|
+
Keep a shell and multiple managed agents visible in the same tmux window.
|
|
112
|
+
Move between panes to start independent tasks while projmux collects their
|
|
113
|
+
permission and completion events in one notification queue.
|
|
114
|
+
|
|
115
|
+
<p align="center">
|
|
116
|
+
<img src="docs/assets/projmux-three-pane-workflow.gif" alt="projmux shell, Codex, and Claude 3-pane workflow demo" width="820">
|
|
117
|
+
<br>
|
|
118
|
+
<em>Move across equal-width shell, Codex, and Claude panes while independent tasks report back through one notification queue.</em>
|
|
119
|
+
</p>
|
|
120
|
+
|
|
121
|
+
## Automation With Agent Skills
|
|
122
|
+
|
|
123
|
+
AI tools can invoke the same projmux CLI to open a managed pane and deliver a
|
|
124
|
+
prompt:
|
|
103
125
|
|
|
104
126
|
```sh
|
|
105
|
-
projmux ai split --agent codex right
|
|
106
|
-
projmux ai split --agent claude down
|
|
107
|
-
projmux ai split --agent antigravity right
|
|
127
|
+
projmux ai split --agent codex right -- "Review the retry logic."
|
|
108
128
|
```
|
|
109
129
|
|
|
110
|
-
|
|
111
|
-
Claude to use it with a prompt. Claude runs the projmux command, Codex opens in
|
|
112
|
-
a managed pane attached to the current project, and the prompt is delivered
|
|
113
|
-
there immediately.
|
|
114
|
-
projmux tracks hook events from the opened pane and shows permission or
|
|
115
|
-
completion notifications in tmux.
|
|
116
|
-
Antigravity uses the same managed split path, with manual hook ingest and
|
|
117
|
-
session resume support documented in the CLI reference.
|
|
118
|
-
|
|
119
|
-
Install templates and naming conventions are in
|
|
130
|
+
Templates and naming conventions for Claude, Codex, and other agents are in
|
|
120
131
|
[AI Agent Shortcuts](docs/ai-agent-shortcuts.md).
|
|
121
132
|
|
|
122
|
-
<p align="center">
|
|
123
|
-
<img src="docs/assets/projmux-skill-workflow.gif" alt="projmux skill workflow demo" width="820">
|
|
124
|
-
<br>
|
|
125
|
-
<em>Claude invokes a registered projmux skill with a prompt, opens a managed Codex pane, and Codex answers there.</em>
|
|
126
|
-
</p>
|
|
127
|
-
|
|
128
133
|
## More Docs
|
|
129
134
|
|
|
130
135
|
- [Install](docs/install.md)
|
package/bin/projmux
CHANGED
|
Binary file
|