You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Refresh the user-facing feature list with the lightweight /btw side-question flow and concise background task panel behavior. Keep the subagent planning description focused on user-visible behavior rather than implementation details.
Co-authored-by: Open Codex <hff582580@gmail.com>
Copy file name to clipboardExpand all lines: README.md
+46-28Lines changed: 46 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -126,18 +126,29 @@ From recent fork-specific changes:
126
126
127
127
This closes the UX gap between "the request was submitted with xhigh" and "the footer still looks like high": the status line now describes the active foreground turn without making a temporary marker look like a persistent configuration change.
128
128
129
-
### 7. Parallel-first subagent planning policy
129
+
### 7. Lightweight `/btw` side questions
130
+
131
+
From recent fork-specific changes:
132
+
133
+
- ask quick side questions with `/btw <question>` without taking over the main chat
134
+
- keep short follow-ups inside the BTW bottom pane instead of turning them into the primary task
135
+
- use the same model, effort, permission, and tool behavior users expect from the main session
136
+
137
+
This is intended for "by the way" questions that are useful during work but should not become the primary task thread.
138
+
139
+
### 8. Parallel-first subagent planning policy
130
140
131
141
Implemented through the user-scope `~/.codex/AGENTS.md` instruction layer, with an extracted repo example in [`docs/parallel-first-agent-execution.md`](docs/parallel-first-agent-execution.md):
132
142
133
143
- overrides Codex's default conservative stance against automatic agent spawning with an explicit, more aggressive subagent policy for complex work
134
144
- classifies non-trivial work by independent investigation, review, test, docs, and validation axes before editing
135
145
- prefers read-only subagents for evidence gathering, with one final implementation lane unless edit boundaries are clearly disjoint
- keeps the stable profile set small (`default`, `explorer`, `worker`) while describing each subtask with clear task context and ownership
147
+
- encourages subagents across exploration, review, verification, and release checks when those lanes are genuinely independent
137
148
138
149
This is an instruction-policy feature rather than a hardcoded scheduler: it enables a more aggressive subagent mechanism while keeping shared-file edits coordinated.
139
150
140
-
### 8. Nonblocking background execution
151
+
### 9. Nonblocking background execution
141
152
142
153
From recent fork-specific TUI changes:
143
154
@@ -148,19 +159,17 @@ The feature is centered on two background lanes:
148
159
149
160
The shared interaction model is:
150
161
151
-
-**Manual backgrounding** — `Ctrl+B` sends the current active exec/terminal activity to the background without submitting a core op, clearing the foreground task-running UI while preserving streamed output.
152
-
-**Foreground state** — foreground model activity still drives the normal `Working` status, while background work is counted separately in the status line as `bg <n> subagent / <m> terminal`.
153
-
-**Down task panel** — pressing `Down` opens a persistent bottom-pane task panel instead of inserting a chat-stream summary. The panel updates in place and separates `Tasks`, `Subagents`, and `Terminals`.
154
-
-**List navigation** — `Up`/`Down` moves selection, `Enter` opens details, `x` stops the selected stoppable terminal, and `Esc`/`Left` closes the panel.
155
-
-**Terminal details** — terminal detail view shows status, elapsed runtime, wrapped command/task metadata, and the recent output tail. `x` stops the terminal through the same cleanup path as `/stop` when the terminal is stoppable.
156
-
-**Slash commands** — `/ps` prints a chat-history summary of running background terminals, while `/stop` terminates all running background terminal processes for the thread.
157
-
-**Subagent details** — subagent detail view shows agent title, role, task prompt, status, elapsed runtime, and progress lines. Subagents are inspectable in the background picker and switchable through the agent-thread workflow; non-stoppable subagents do not expose `x stop`.
158
-
-**Plan tasks** — the same `Down` panel also surfaces the latest visible plan/task list, including completed tasks, so task history is inspectable without relying only on the compact status-line count.
159
-
-**Completed background work** — completed background exec cells are flushed back into history once they finish, preserving the command and captured output without re-foregrounding the task.
162
+
-`Ctrl+B` sends the current terminal activity to the background while keeping streamed output available.
163
+
-`Down` opens a live task panel with separate `Tasks`, `Subagents`, and `Terminals` sections.
164
+
-`Enter` opens details, `x` stops the selected stoppable background item, and `Esc`/`Left` closes the panel.
165
+
- the status line keeps foreground `Working` state separate from background subagent/terminal counts.
166
+
- terminal details show runtime and recent output; subagent details show role, task, status, runtime, progress, and task-boundary context.
167
+
-`/agent` shows available agent profiles, while `/subagents` keeps the subagent thread picker/switching workflow.
168
+
- completed background command output is preserved in history without pulling the task back into the foreground.
160
169
161
170
This is the essential interaction change behind the Claude Code-style behavior: background work stays visible and controllable, but it no longer blocks normal chat flow.
162
171
163
-
### 9. Status line token throughput visibility (Beta)
172
+
### 10. Status line token throughput visibility (Beta)
164
173
165
174
From commit `85e937b855`:
166
175
@@ -171,7 +180,7 @@ From commit `85e937b855`:
171
180
172
181
This is intentionally marked **Beta**: the current value is useful as a rough responsiveness signal, but it is not yet an exact real-time throughput metric.
173
182
174
-
### 10. Workspace git status in the status line
183
+
### 11. Workspace git status in the status line
175
184
176
185
The status line can now surface the current workspace diff through the configurable `workspace-changes` item:
0 commit comments