Skip to content

Commit fb23009

Browse files
committed
Document effort controls in README
Add the /effort and query-marker xhigh behavior to the current fork delta, including per-turn status-line visibility. Keep the English and Chinese sections aligned after the new feature entry.
1 parent 954f175 commit fb23009

1 file changed

Lines changed: 32 additions & 8 deletions

File tree

README.md

Lines changed: 32 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,19 @@ From recent fork-specific changes:
105105

106106
This brings a Claude Code-style export flow into the TUI without requiring external scripts or manual transcript scraping.
107107

108-
### 6. Parallel-first subagent planning policy
108+
### 6. Reasoning effort controls and per-turn status visibility
109+
110+
From recent fork-specific changes:
111+
112+
- adds `/effort` for changing the active reasoning effort directly from the TUI
113+
- supports one-turn high-effort markers in the user query: standalone `ulw`, `ultra`, or `xhigh` submit that turn with `xhigh` reasoning
114+
- keeps marker-based `xhigh` current-turn-only, so it does not mutate the session's default effort
115+
- shows the submitted per-turn effort in the `model-with-reasoning` status-line item while that foreground turn is pending or running
116+
- restores the status line to the session/default effort when the turn completes, fails, or is interrupted
117+
118+
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.
119+
120+
### 7. Parallel-first subagent planning policy
109121

110122
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):
111123

@@ -116,7 +128,7 @@ Implemented through the user-scope `~/.codex/AGENTS.md` instruction layer, with
116128

117129
This is an instruction-policy feature rather than a hardcoded scheduler: it enables a more aggressive subagent mechanism while keeping shared-file edits coordinated.
118130

119-
### 7. Nonblocking background execution
131+
### 8. Nonblocking background execution
120132

121133
From recent fork-specific TUI changes:
122134

@@ -139,7 +151,7 @@ The shared interaction model is:
139151

140152
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.
141153

142-
### 8. Status line token throughput visibility (Beta)
154+
### 9. Status line token throughput visibility (Beta)
143155

144156
From commit `85e937b855`:
145157

@@ -150,7 +162,7 @@ From commit `85e937b855`:
150162

151163
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.
152164

153-
### 9. Workspace git status in the status line
165+
### 10. Workspace git status in the status line
154166

155167
The status line can now surface the current workspace diff through the configurable `workspace-changes` item:
156168

@@ -353,7 +365,19 @@ Codex CLI 是开源的,但上游仓库当前对外部代码贡献采用 invita
353365

354366
这让类似 Claude Code 的会话导出能力直接进入 TUI,而不需要额外脚本或手工抓 transcript。
355367

356-
### 6. Parallel-first subagent planning policy
368+
### 6. Reasoning effort 控制与单 turn 状态可见性
369+
370+
来自最近几条 fork 自有改动:
371+
372+
- 增加 `/effort`,可以直接在 TUI 中切换当前 reasoning effort
373+
- 支持在用户 query 中用 standalone `ulw``ultra``xhigh` 触发单 turn `xhigh` reasoning
374+
- marker 触发的 `xhigh` 保持 current-turn-only,不会修改 session 默认 effort
375+
- 当前 foreground turn 处于 pending/running 时,`model-with-reasoning` status-line item 会显示这次提交实际使用的 per-turn effort
376+
- turn 完成、失败或被打断后,status line 会恢复为 session/default effort
377+
378+
这补上了“请求实际按 xhigh 提交,但底部仍显示 high”的 UX 缺口:status line 会描述当前前台 turn,但不会把一次性的 marker 伪装成持久配置变更。
379+
380+
### 7. Parallel-first subagent planning policy
357381

358382
通过 user-scope `~/.codex/AGENTS.md` 指令层实现,并在 repo 中抽取了示例文件:[`docs/parallel-first-agent-execution.md`](docs/parallel-first-agent-execution.md)
359383

@@ -364,7 +388,7 @@ Codex CLI 是开源的,但上游仓库当前对外部代码贡献采用 invita
364388

365389
这不是硬编码 scheduler,而是 instruction-policy feature:它启用了更激进的 subagent 机制,同时避免多个执行 lane 争抢同一批文件。
366390

367-
### 7. 非阻塞后台执行
391+
### 8. 非阻塞后台执行
368392

369393
来自最近几条 fork 自有 TUI 改动:
370394

@@ -387,7 +411,7 @@ Codex CLI 是开源的,但上游仓库当前对外部代码贡献采用 invita
387411

388412
这是 Claude Code 风格体验背后的本质交互变化:后台工作仍然可见、可管理,但不会阻塞正常聊天流。
389413

390-
### 8. Status line token throughput visibility(Beta)
414+
### 9. Status line token throughput visibility(Beta)
391415

392416
来自 commit `85e937b855`
393417

@@ -398,7 +422,7 @@ Codex CLI 是开源的,但上游仓库当前对外部代码贡献采用 invita
398422

399423
这个能力目前标记为 **Beta**:它可以作为粗略 responsiveness signal,但还不是准确的 real-time throughput metric。
400424

401-
### 9. Status line 中显示 workspace git status
425+
### 10. Status line 中显示 workspace git status
402426

403427
status line 现在可以通过可配置的 `workspace-changes` item 显示当前 workspace diff:
404428

0 commit comments

Comments
 (0)