@viraatdas/rudder 2.2.2 → 2.2.3
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 +25 -21
- package/dist/native/rudder-native +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -82,6 +82,8 @@ to `~/.rudder/config.json`.
|
|
|
82
82
|
│ agents │ worker │
|
|
83
83
|
│ task list │ live Claude Code or Codex terminal │
|
|
84
84
|
│ status/model │ DAG-over-orchestrator, scrollback, review │
|
|
85
|
+
├───────────────┴────────────────────────────────────────────┤
|
|
86
|
+
│ task input: route one-off vs plan, slash commands, refine │
|
|
85
87
|
└──────────────────────────────────────────────────────────────┘
|
|
86
88
|
```
|
|
87
89
|
|
|
@@ -90,8 +92,10 @@ to `~/.rudder/config.json`.
|
|
|
90
92
|
your keystrokes go straight to the agent, so its prompts, slash commands,
|
|
91
93
|
selection, and `Tab` all work normally.
|
|
92
94
|
- **orchestrator** (right, when selected): a Claude Code PTY with the live DAG
|
|
93
|
-
rendered above it.
|
|
94
|
-
|
|
95
|
+
rendered above it. For planned work, use it to inspect/refine the plan while
|
|
96
|
+
the bottom task input remains the primary place to type new requests.
|
|
97
|
+
- **task** (bottom): the entry point for fresh requests, slash commands, plan
|
|
98
|
+
refinements, and approval with empty `Enter`.
|
|
95
99
|
|
|
96
100
|
Mouse wheel and trackpad scroll the pane under the pointer. Over the worker or
|
|
97
101
|
review pane they scroll Rudder's captured scrollback.
|
|
@@ -102,12 +106,12 @@ review pane they scroll Rudder's captured scrollback.
|
|
|
102
106
|
|
|
103
107
|
| Key | Action |
|
|
104
108
|
| --- | --- |
|
|
105
|
-
| `Option-1` / `Option-2` | Focus the agents or
|
|
109
|
+
| `Option-1` / `Option-2` / `Option-3` | Focus the agents, worker, or task pane |
|
|
106
110
|
| `Option-v` | Toggle the selected agent's review view |
|
|
107
111
|
| `Cmd-C` | Copy the active Rudder selection |
|
|
108
112
|
| `Ctrl-C` | Quit (asks to confirm if agents are still running) |
|
|
109
113
|
|
|
110
|
-
`Option-1/2` work out of the box on macOS terminals, whether or not "Use Option
|
|
114
|
+
`Option-1/2/3` work out of the box on macOS terminals, whether or not "Use Option
|
|
111
115
|
as Meta" is enabled.
|
|
112
116
|
|
|
113
117
|
**Leader: press `Ctrl-W`, then one key.** A reliable way to run a dashboard
|
|
@@ -115,7 +119,7 @@ command, even while typing inside the worker pane:
|
|
|
115
119
|
|
|
116
120
|
| Then press | Action |
|
|
117
121
|
| --- | --- |
|
|
118
|
-
| `1` / `2` | Focus agents / worker |
|
|
122
|
+
| `1` / `2` / `3` | Focus agents / worker / task |
|
|
119
123
|
| `v` | Toggle review |
|
|
120
124
|
| `m` | Merge the selected completed worktree |
|
|
121
125
|
| `M` | Merge all completed worktrees |
|
|
@@ -137,13 +141,13 @@ scroll the pane.
|
|
|
137
141
|
the worker, `m` / `M` / `R` / `r` / `d` act on the selection, `x` stops a running
|
|
138
142
|
agent (keeping its worktree), and `g` toggles the nested DAG view.
|
|
139
143
|
|
|
140
|
-
## Orchestrator Skills
|
|
144
|
+
## Commands and Orchestrator Skills
|
|
141
145
|
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
146
|
+
Type these in the bottom task input. When an interactive Claude orchestrator is
|
|
147
|
+
running, Rudder also exposes matching project skills; the orchestrator can write
|
|
148
|
+
`RUDDER_*` control markers in `RUDDER.md` and Rudder consumes them.
|
|
145
149
|
|
|
146
|
-
|
|
|
150
|
+
| Command | Action |
|
|
147
151
|
| --- | --- |
|
|
148
152
|
| `/model` | Pick provider, then model, then effort |
|
|
149
153
|
| `/ask <text>` | Force a one-off conversational agent in the main checkout |
|
|
@@ -159,11 +163,10 @@ consumes the resulting `RUDDER_*` control markers in `RUDDER.md`.
|
|
|
159
163
|
|
|
160
164
|
## Models
|
|
161
165
|
|
|
162
|
-
|
|
163
|
-
`
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
means Rudder passes no override.
|
|
166
|
+
Use `/model [provider] [model] [effort]` in the task input. Claude offers
|
|
167
|
+
aliases like `sonnet`, `opus`, `haiku` (and the `[1m]` long-context variants);
|
|
168
|
+
Codex offers `gpt-5.5`, `gpt-5.4-codex`, and other discovered models. `auto`
|
|
169
|
+
effort means Rudder passes no override.
|
|
167
170
|
|
|
168
171
|
Your last provider, model, and effort are saved in `~/.rudder/config.json` and
|
|
169
172
|
reused next time. Rudder refreshes model metadata from
|
|
@@ -171,7 +174,7 @@ reused next time. Rudder refreshes model metadata from
|
|
|
171
174
|
|
|
172
175
|
## Dispatch and planning
|
|
173
176
|
|
|
174
|
-
|
|
177
|
+
Type a fresh request in the bottom task input. When no plan is active, Rudder
|
|
175
178
|
first routes it through a small Haiku dispatcher:
|
|
176
179
|
|
|
177
180
|
- **One-off** for questions, explanations, docs/API research, repo inspection, or
|
|
@@ -197,14 +200,15 @@ implementation.
|
|
|
197
200
|
1. Which time range: last 4 weeks, 6 months, or all time?
|
|
198
201
|
2. Reuse the existing module contract, or rebuild from scratch?
|
|
199
202
|
|
|
200
|
-
↳ answer in the
|
|
203
|
+
↳ answer in the task input (e.g. "1: ..., 2: ...")
|
|
201
204
|
```
|
|
202
205
|
|
|
203
|
-
Type your answer
|
|
204
|
-
conversation with your answer.
|
|
206
|
+
Type your answer in the task input; Rudder resumes the same planning
|
|
207
|
+
conversation with your answer. The focused orchestrator pane can also accept
|
|
208
|
+
a follow-up when it is showing the planner chat.
|
|
205
209
|
2. **It lays out a DAG.** When it is ready it shows the task DAG (a tree of worker tasks
|
|
206
|
-
with their dependencies) above the orchestrator terminal.
|
|
207
|
-
to refine it, or approve/launch
|
|
210
|
+
with their dependencies) above the orchestrator terminal. Type feedback in the
|
|
211
|
+
task input to refine it, or press empty `Enter` to approve/launch.
|
|
208
212
|
3. **The fleet runs.** The scheduler drains the DAG (todo → in-progress → review → done) as
|
|
209
213
|
dependencies merge, each task in its own isolated worktree.
|
|
210
214
|
|
|
Binary file
|
package/package.json
CHANGED