Skip to content

armgit / codex

Public Imported from GitHub
0

Lightweight coding agent that runs in your terminal

Rust

Add configurable shortcuts for the agents dashboard (#39142)

Eric Trautf47f77ada669
diff --git a/codex-rs/config/src/tui_keymap.rs b/codex-rs/config/src/tui_keymap.rs
index 5bd8933ecc..a11ade8d0e 100644
--- a/codex-rs/config/src/tui_keymap.rs
+++ b/codex-rs/config/src/tui_keymap.rs
@@ -92,6 +92,8 @@ impl KeybindingsSpec {
#[serde(deny_unknown_fields)]
#[schemars(deny_unknown_fields)]
pub struct TuiGlobalKeymap {
+ /// Open the shared agent-session overview.
+ pub open_agents: Option<KeybindingsSpec>,
/// Open the transcript overlay.
pub open_transcript: Option<KeybindingsSpec>,
/// Open the external editor for the current draft.
@@ -367,6 +369,23 @@ pub struct TuiListKeymap {
pub cancel: Option<KeybindingsSpec>,
}
+/// Shortcuts specific to the shared agents overview.
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, Default, JsonSchema)]
+#[serde(deny_unknown_fields)]
+#[schemars(deny_unknown_fields)]
+pub struct TuiAgentsKeymap {
+ /// Search the available agent tasks.
+ pub search: Option<KeybindingsSpec>,
+ /// Start composing a new agent task.
+ pub new_task: Option<KeybindingsSpec>,
+ /// Rename the selected task.
+ pub rename: Option<KeybindingsSpec>,
+ /// Stop the selected running task.
+ pub stop: Option<KeybindingsSpec>,
+ /// Toggle grouping tasks by status or project.
+ pub toggle_grouping: Option<KeybindingsSpec>,
+}
+
/// Approval overlay keybindings.
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, Default, JsonSchema)]
#[serde(deny_unknown_fields)]
@@ -423,6 +442,8 @@ pub struct TuiKeymap {
#[serde(default)]
pub list: TuiListKeymap,
#[serde(default)]
+ pub agents: TuiAgentsKeymap,
+ #[serde(default)]
pub approval: TuiApprovalKeymap,
}
diff --git a/codex-rs/config/src/types.rs b/codex-rs/config/src/types.rs
index c78ed69867..148fef00f7 100644
--- a/codex-rs/config/src/types.rs
+++ b/codex-rs/config/src/types.rs
@@ -31,6 +31,7 @@ use serde::Serialize;
pub use crate::tui_keymap::KeybindingSpec;
pub use crate::tui_keymap::KeybindingsSpec;
pub use crate::tui_keymap::MAX_FUNCTION_KEY;
+pub use crate::tui_keymap::TuiAgentsKeymap;
pub use crate::tui_keymap::TuiApprovalKeymap;
pub use crate::tui_keymap::TuiChatKeymap;
pub use crate::tui_keymap::TuiComposerKeymap;
diff --git a/codex-rs/core/config.schema.json b/codex-rs/core/config.schema.json
index a5bd4aac33..c9711688ef 100644
--- a/codex-rs/core/config.schema.json
+++ b/codex-rs/core/config.schema.json
@@ -3469,6 +3469,13 @@
}
],
"default": {
+ "agents": {
+ "new_task": null,
+ "rename": null,
+ "search": null,
+ "stop": null,
+ "toggle_grouping": null
+ },
"approval": {
"approve": null,
"approve_for_prefix": null,
@@ -3514,6 +3521,7 @@
"global": {
"clear_terminal": null,
"copy": null,
+ "open_agents": null,
"open_external_editor": null,
"open_transcript": null,
"queue": null,
@@ -3724,6 +3732,53 @@
},
"type": "object"
},
+ "TuiAgentsKeymap": {
+ "additionalProperties": false,
+ "description": "Shortcuts specific to the shared agents overview.",
+ "properties": {
+ "new_task": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/KeybindingsSpec"
+ }
+ ],
+ "description": "Start composing a new agent task."
+ },
+ "rename": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/KeybindingsSpec"
+ }
+ ],
+ "description": "Rename the selected task."
+ },
+ "search": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/KeybindingsSpec"
+ }
+ ],
+ "description": "Search the available agent tasks."
+ },
+ "stop": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/KeybindingsSpec"
+ }
+ ],
+ "description": "Stop the selected running task."
+ },
+ "toggle_grouping": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/KeybindingsSpec"
+ }
+ ],
+ "description": "Toggle grouping tasks by status or project."
+ }
+ },
+ "type": "object"
+ },
"TuiApprovalKeymap": {
"additionalProperties": false,
"description": "Approval overlay keybindings.",
@@ -4044,6 +4099,14 @@
],
"description": "Copy the last agent response to the clipboard."
},
+ "open_agents": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/KeybindingsSpec"
+ }
+ ],
+ "description": "Open the shared agent-session overview."
+ },
"open_external_editor": {
"allOf": [
{
@@ -4123,6 +4186,20 @@
"additionalProperties": false,
"description": "Raw keymap configuration from `[tui.keymap]`.\n\nEach context contains action-level overrides. Missing actions inherit from built-in defaults, and selected chat/composer actions can fall back through `global` during runtime resolution.\n\nThis type is intentionally a persistence shape, not the structure used by input handlers. Runtime consumers should resolve it into `RuntimeKeymap` first so precedence, empty-list unbinding, and duplicate-key validation are applied consistently.",
"properties": {
+ "agents": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/TuiAgentsKeymap"
+ }
+ ],
+ "default": {
+ "new_task": null,
+ "rename": null,
+ "search": null,
+ "stop": null,
+ "toggle_grouping": null
+ }
+ },
"approval": {
"allOf": [
{
@@ -4202,6 +4279,7 @@
"default": {
"clear_terminal": null,
"copy": null,
+ "open_agents": null,
"open_external_editor": null,
"open_transcript": null,
"queue": null,
diff --git a/codex-rs/tui/src/app/agents_overview_tests.rs b/codex-rs/tui/src/app/agents_overview_tests.rs
index 416a1e914b..cc4f5b894e 100644
--- a/codex-rs/tui/src/app/agents_overview_tests.rs
+++ b/codex-rs/tui/src/app/agents_overview_tests.rs
@@ -14,6 +14,9 @@ use codex_app_server_protocol::ThreadActiveFlag;
use codex_app_server_protocol::ThreadUnsubscribeParams;
use codex_app_server_protocol::ThreadUnsubscribeResponse;
use codex_app_server_protocol::ThreadUnsubscribeStatus;
+use codex_config::types::KeybindingSpec;
+use codex_config::types::KeybindingsSpec;
+use codex_config::types::TuiKeymap;
use codex_protocol::protocol::SubAgentSource;
static OVERVIEW_TIMESTAMP: std::sync::LazyLock<i64> =
@@ -273,6 +276,63 @@ async fn embedded_sessions_offer_to_start_a_background_server_without_migrating(
app_server.shutdown().await.expect("shutdown app server");
}
+#[tokio::test]
+async fn filtered_dashboard_actions_use_configured_shortcuts() {
+ let mut app = make_test_app().await;
+ let mut keymap = TuiKeymap::default();
+ keymap.agents.search = Some(KeybindingsSpec::One(KeybindingSpec("f6".to_string())));
+ keymap.agents.stop = Some(KeybindingsSpec::One(KeybindingSpec("f10".to_string())));
+ app.keymap = crate::keymap::RuntimeKeymap::from_config(&keymap).expect("runtime keymap");
+ let first = ThreadId::new();
+ let second = ThreadId::new();
+ let (event_tx, mut event_rx) = tokio::sync::mpsc::unbounded_channel();
+ let mut view = AgentsOverviewView::new(
+ app.agents_overview_view(
+ vec![
+ overview_thread(
+ first,
+ /*parent_thread_id*/ None,
+ "First task",
+ ThreadStatus::Idle,
+ ),
+ overview_thread(
+ second,
+ /*parent_thread_id*/ None,
+ "Second task",
+ ThreadStatus::Active {
+ active_flags: Vec::new(),
+ },
+ ),
+ ],
+ Some(first),
+ )
+ .rows
+ .clone(),
+ Some(first),
+ /*exit_on_cancel*/ false,
+ crate::app_event_sender::AppEventSender::new(event_tx),
+ app.keymap.clone(),
+ Arc::default(),
+ );
+
+ view.handle_key_event(KeyEvent::new(KeyCode::F(10), KeyModifiers::NONE));
+ assert!(event_rx.try_recv().is_err());
+ assert!(view.handle_paste("Do not dispatch this draft".to_string()));
+ view.handle_key_event(KeyEvent::new(KeyCode::F(6), KeyModifiers::NONE));
+ assert!(view.handle_paste("Second task".to_string()));
+ view.handle_key_event(KeyEvent::new(KeyCode::F(10), KeyModifiers::NONE));
+ assert!(matches!(
+ event_rx.try_recv(),
+ Ok(AppEvent::StopAgentsOverviewThread { thread_id }) if thread_id == second
+ ));
+ view.handle_key_event(KeyEvent::new(KeyCode::Enter, KeyModifiers::NONE));
+ assert!(matches!(
+ event_rx.try_recv(),
+ Ok(AppEvent::SelectAgentsOverviewThread { thread_id }) if thread_id == second
+ ));
+ assert!(event_rx.try_recv().is_err());
+}
+
#[tokio::test]
async fn failed_root_switch_keeps_background_requests_on_the_active_session() -> Result<()> {
let mut app = make_test_app().await;
diff --git a/codex-rs/tui/src/app/agents_overview_view.rs b/codex-rs/tui/src/app/agents_overview_view.rs
index e6334037d9..17fe648d20 100644
--- a/codex-rs/tui/src/app/agents_overview_view.rs
+++ b/codex-rs/tui/src/app/agents_overview_view.rs
@@ -5,7 +5,10 @@ use crate::app_event::AppEvent;
use crate::app_event_sender::AppEventSender;
use crate::bottom_pane::BottomPaneView;
use crate::bottom_pane::ViewCompletion;
+use crate::key_hint::KeyBindingListExt;
+use crate::key_hint::ShortcutHint;
use crate::key_hint::is_plain_text_key_event;
+use crate::keymap::AgentsKeymap;
use crate::keymap::KeymapContext;
use crate::keymap::KeymapContextSet;
use crate::keymap::ListAction;
@@ -18,7 +21,6 @@ use codex_app_server_protocol::ThreadStatus;
use codex_protocol::ThreadId;
use crossterm::event::KeyCode;
use crossterm::event::KeyEvent;
-use crossterm::event::KeyModifiers;
use ratatui::buffer::Buffer;
use ratatui::layout::Constraint;
use ratatui::layout::Layout;
@@ -98,6 +100,7 @@ pub(super) struct AgentsOverviewView {
completion: Option<ViewCompletion>,
app_event_tx: AppEventSender,
keymap: ListKeymap,
+ agents_keymap: AgentsKeymap,
}
impl Drop for AgentsOverviewView {
@@ -135,6 +138,7 @@ impl AgentsOverviewView {
completion: None,
app_event_tx,
keymap: keymap.list,
+ agents_keymap: keymap.agents,
};
let visible = view.visible_indices();
if !visible.contains(&view.selected) {
@@ -419,7 +423,7 @@ impl BottomPaneView for AgentsOverviewView {
}
fn keymap_contexts(&self) -> KeymapContextSet {
- KeymapContextSet::new(KeymapContext::List)
+ KeymapContextSet::new(KeymapContext::List).with(KeymapContext::Agents)
}
fn completion(&self) -> Option<ViewCompletion> {
@@ -441,58 +445,69 @@ impl BottomPaneView for AgentsOverviewView {
}
fn handle_key_event(&mut self, key: KeyEvent) {
- if key.modifiers == KeyModifiers::CONTROL
- && matches!(key.code, KeyCode::Char('f' | 'n' | 'r' | 's' | 'x'))
+ if key.code == KeyCode::Backspace
+ && key.modifiers.is_empty()
+ && self.keymap.action_for(key).is_none()
{
- match key.code {
- KeyCode::Char('s') => {
- let mut state = self.state.lock().unwrap_or_else(PoisonError::into_inner);
- state.status_grouping = !state.status_grouping;
- }
- KeyCode::Char('f') => {
- let mut state = self.state.lock().unwrap_or_else(PoisonError::into_inner);
- if !state.renaming {
- state.searching = !state.searching;
- if !state.searching {
- state.search.clear();
- }
- }
+ self.edit_input(|input| {
+ input.pop();
+ });
+ return;
+ }
+ if is_plain_text_key_event(key)
+ && let KeyCode::Char(character) = key.code
+ {
+ self.edit_input(|input| input.push(character));
+ return;
+ }
+
+ if self.agents_keymap.toggle_grouping.is_pressed(key) {
+ let mut state = self.state();
+ state.status_grouping = !state.status_grouping;
+ return;
+ }
+ if self.agents_keymap.search.is_pressed(key) {
+ let mut state = self.state();
+ if !state.renaming {
+ state.searching = !state.searching;
+ if !state.searching {
+ state.search.clear();
}
- KeyCode::Char('n') => {
- let mut state = self.state.lock().unwrap_or_else(PoisonError::into_inner);
+ }
+ return;
+ }
+ if self.agents_keymap.new_task.is_pressed(key) {
+ let mut state = self.state();
+ state.search.clear();
+ state.searching = false;
+ state.renaming = false;
+ state.input.clear();
+ return;
+ }
+ if self.agents_keymap.rename.is_pressed(key) {
+ if let Some(row) = self.selected_row() {
+ let mut state = self.state();
+ if state.input.is_empty() {
+ state.input = row.thread.name.clone().unwrap_or_default();
state.search.clear();
state.searching = false;
- state.renaming = false;
- state.input.clear();
+ state.renaming = true;
}
- KeyCode::Char('r') => {
- if let Some(row) = self.selected_row() {
- let mut state = self.state.lock().unwrap_or_else(PoisonError::into_inner);
- if state.input.is_empty() {
- state.input = row.thread.name.clone().unwrap_or_default();
- state.search.clear();
- state.searching = false;
- state.renaming = true;
- }
- }
- }
- KeyCode::Char('x') => {
- if let Some(row) = self.selected_row()
- && matches!(row.thread.status, ThreadStatus::Active { .. })
- {
- self.app_event_tx.send(AppEvent::StopAgentsOverviewThread {
- thread_id: row.thread_id,
- });
- }
- }
- _ => {}
+ }
+ return;
+ }
+ if self.agents_keymap.stop.is_pressed(key) {
+ if let Some(row) = self.selected_row()
+ && matches!(row.thread.status, ThreadStatus::Active { .. })
+ {
+ self.app_event_tx.send(AppEvent::StopAgentsOverviewThread {
+ thread_id: row.thread_id,
+ });
}
return;
}
- if !is_plain_text_key_event(key)
- && let Some(action) = self.keymap.action_for(key)
- {
+ if let Some(action) = self.keymap.action_for(key) {
if self.state().renaming
&& matches!(action, ListAction::JumpTop | ListAction::JumpBottom)
{
@@ -532,21 +547,10 @@ impl BottomPaneView for AgentsOverviewView {
}
ListAction::MoveLeft | ListAction::MoveRight => {}
}
- return;
- }
-
- match key.code {
- KeyCode::Backspace => {
- self.edit_input(|input| {
- input.pop();
- });
- }
- KeyCode::Char(character)
- if key.modifiers.is_empty() || key.modifiers == KeyModifiers::SHIFT =>
- {
- self.edit_input(|input| input.push(character));
- }
- _ => {}
+ } else if key.code == KeyCode::Backspace {
+ self.edit_input(|input| {
+ input.pop();
+ });
}
}
}
@@ -650,30 +654,85 @@ impl Renderable for AgentsOverviewView {
let input = &input[visible_start..];
Line::from(vec![label.cyan().bold(), input.into(), placeholder.dim()])
.render(inset(prompt), buf);
- let stop_hint = if self
- .selected_row()
- .is_some_and(|row| matches!(row.thread.status, ThreadStatus::Active { .. }))
- {
- "ctrl+x".bold()
- } else {
- "ctrl+x".dim()
+ let list_hint = |action| {
+ self.keymap.primary_hint(action).filter(|hint| {
+ !matches!(hint, ShortcutHint::Single(binding)
+ if is_plain_text_key_event(KeyEvent::new(
+ binding.parts().0,
+ binding.parts().1,
+ )) || [
+ &self.agents_keymap.search,
+ &self.agents_keymap.new_task,
+ &self.agents_keymap.rename,
+ &self.agents_keymap.stop,
+ &self.agents_keymap.toggle_grouping,
+ ]
+ .into_iter()
+ .any(|bindings| bindings.contains(binding)))
+ })
};
- Line::from(vec![
- "↑↓".bold(),
- " navigate ".dim(),
- "enter".bold(),
- " open ".dim(),
- "ctrl+f".bold(),
- " search ".dim(),
- "ctrl+s".bold(),
- " group ".dim(),
- "ctrl+r".bold(),
- " rename ".dim(),
- stop_hint,
- " stop ".dim(),
- "esc".bold(),
- " back".dim(),
- ])
- .render(inset(footer), buf);
+ let navigation_hints = [ListAction::MoveUp, ListAction::MoveDown]
+ .into_iter()
+ .filter_map(list_hint)
+ .map(|hint| hint.display_label().replace(" + ", "+"))
+ .collect::<Vec<_>>();
+ let navigation_hint = navigation_hints.join(
+ if navigation_hints
+ .iter()
+ .all(|hint| hint.chars().count() == 1)
+ {
+ ""
+ } else {
+ " "
+ },
+ );
+ let mut footer_spans = Vec::new();
+ if !navigation_hint.is_empty() {
+ footer_spans.extend([navigation_hint.bold(), " navigate ".dim()]);
+ }
+ let mut add_hint = |hint: Option<ShortcutHint>, label: &'static str, enabled: bool| {
+ if let Some(hint) = hint {
+ let key = hint.display_label().replace(" + ", "+");
+ footer_spans.push(if enabled { key.bold() } else { key.dim() });
+ footer_spans.push(format!(" {label} ").dim());
+ }
+ };
+ add_hint(list_hint(ListAction::Accept), "open", true);
+ add_hint(
+ self.agents_keymap
+ .primary_hint("search", &self.agents_keymap.search),
+ "search",
+ true,
+ );
+ add_hint(
+ self.agents_keymap
+ .primary_hint("toggle_grouping", &self.agents_keymap.toggle_grouping),
+ "group",
+ true,
+ );
+ add_hint(
+ self.agents_keymap
+ .primary_hint("rename", &self.agents_keymap.rename),
+ "rename",
+ true,
+ );
+ add_hint(
+ self.agents_keymap
+ .primary_hint("stop", &self.agents_keymap.stop),
+ "stop",
+ self.selected_row()
+ .is_some_and(|row| matches!(row.thread.status, ThreadStatus::Active { .. })),
+ );
+ add_hint(list_hint(ListAction::Cancel), "back", true);
+ let footer_area = inset(footer);
+ let mut footer_line: Line = footer_spans.into();
+ if footer_line.width() > usize::from(footer_area.width) {
+ for span in &mut footer_line.spans {
+ if span.content.ends_with(" ") {
+ span.content.to_mut().pop();
+ }
+ }
+ }
+ footer_line.render(footer_area, buf);
}
}
diff --git a/codex-rs/tui/src/app/input.rs b/codex-rs/tui/src/app/input.rs
index 526905ac1f..814f8be3d5 100644
--- a/codex-rs/tui/src/app/input.rs
+++ b/codex-rs/tui/src/app/input.rs
@@ -342,6 +342,11 @@ impl App {
return;
}
+ if app_keymap_shortcuts_available && self.keymap.app.open_agents.is_pressed(key_event) {
+ self.open_agents_overview(app_server);
+ return;
+ }
+
if app_keymap_shortcuts_available && self.keymap.app.open_transcript.is_pressed(key_event) {
self.scrollback_has_older_history = self
.chat_widget
diff --git a/codex-rs/tui/src/keymap.rs b/codex-rs/tui/src/keymap.rs
index 2c1857f442..0234f1316f 100644
--- a/codex-rs/tui/src/keymap.rs
+++ b/codex-rs/tui/src/keymap.rs
@@ -69,11 +69,14 @@ pub(crate) struct RuntimeKeymap {
pub(crate) vim_text_object: VimTextObjectKeymap,
pub(crate) pager: PagerKeymap,
pub(crate) list: ListKeymap,
+ pub(crate) agents: AgentsKeymap,
pub(crate) approval: ApprovalKeymap,
}
#[derive(Clone, Debug)]
pub(crate) struct AppKeymap {
+ /// Open the daemon-wide agent-session overview.
+ pub(crate) open_agents: Vec<KeyBinding>,
/// Open transcript overlay.
pub(crate) open_transcript: Vec<KeyBinding>,
/// Open external editor for the current draft.
@@ -352,6 +355,28 @@ impl ListKeymap {
}
}
+/// Task-management shortcuts specific to the shared agents dashboard.
+#[derive(Clone, Debug)]
+pub(crate) struct AgentsKeymap {
+ pub(crate) search: Vec<KeyBinding>,
+ pub(crate) new_task: Vec<KeyBinding>,
+ pub(crate) rename: Vec<KeyBinding>,
+ pub(crate) stop: Vec<KeyBinding>,
+ pub(crate) toggle_grouping: Vec<KeyBinding>,
+ chord_hints: Arc<RuntimeChordKeymap>,
+}
+
+impl AgentsKeymap {
+ pub(crate) fn primary_hint(
+ &self,
+ action: &'static str,
+ bindings: &[KeyBinding],
+ ) -> Option<ShortcutHint> {
+ let action_id = keymap_action_id(KeymapContext::Agents.config_name(), action)?;
+ self.chord_hints.primary_hint(action_id, bindings)
+ }
+}
+
/// Approval modal keybindings.
///
/// This covers both selection actions and the "open details fullscreen" escape
@@ -541,8 +566,25 @@ impl RuntimeKeymap {
|| configured_context_alias_is_used(&keymap.list, alias)
|| configured_context_alias_is_used(&keymap.approval, alias)
});
+ let open_agents_default_is_shadowed = keymap.global.open_agents.is_none()
+ && (configured_main_surface_alias_is_used(keymap, "alt-a")
+ || configured_context_alias_is_used(&keymap.list, "alt-a")
+ || configured_context_alias_is_used(&keymap.approval, "alt-a")
+ || chords.bindings.iter().any(|binding| {
+ binding.action.context.overlaps(KeymapContext::Global)
+ && binding.chord.prefix.parts() == key_hint::alt(KeyCode::Char('a')).parts()
+ }));
let app = AppKeymap {
+ open_agents: if open_agents_default_is_shadowed {
+ Vec::new()
+ } else {
+ resolve_bindings(
+ keymap.global.open_agents.as_ref(),
+ &defaults.app.open_agents,
+ "tui.keymap.global.open_agents",
+ )?
+ },
open_transcript: resolve_bindings(
keymap.global.open_transcript.as_ref(),
&defaults.app.open_transcript,
@@ -934,6 +976,15 @@ impl RuntimeKeymap {
chord_hints: Arc::clone(&chords),
};
+ let mut agents = AgentsKeymap {
+ search: resolve_local!(keymap, defaults, agents, search),
+ new_task: resolve_local!(keymap, defaults, agents, new_task),
+ rename: resolve_local!(keymap, defaults, agents, rename),
+ stop: resolve_local!(keymap, defaults, agents, stop),
+ toggle_grouping: resolve_local!(keymap, defaults, agents, toggle_grouping),
+ chord_hints: Arc::clone(&chords),
+ };
+
let approval = ApprovalKeymap {
open_fullscreen: resolve_local!(keymap, defaults, approval, open_fullscreen),
open_thread: resolve_local!(keymap, defaults, approval, open_thread),
@@ -951,6 +1002,10 @@ impl RuntimeKeymap {
let list_accept = resolve_local!(keymap, defaults, list, accept);
let list_cancel = resolve_local!(keymap, defaults, list, cancel);
let configured_bindings_to_preserve = configured_bindings_to_preserve([
+ (
+ keymap.global.open_agents.as_ref(),
+ app.open_agents.as_slice(),
+ ),
(
keymap.global.open_transcript.as_ref(),
app.open_transcript.as_slice(),
@@ -1056,6 +1111,26 @@ impl RuntimeKeymap {
chord_hints: Arc::clone(&chords),
};
+ for (configured, bindings) in [
+ (keymap.agents.search.as_ref(), &mut agents.search),
+ (keymap.agents.new_task.as_ref(), &mut agents.new_task),
+ (keymap.agents.rename.as_ref(), &mut agents.rename),
+ (keymap.agents.stop.as_ref(), &mut agents.stop),
+ (
+ keymap.agents.toggle_grouping.as_ref(),
+ &mut agents.toggle_grouping,
+ ),
+ ] {
+ if configured.is_none() {
+ bindings.retain(|binding| {
+ !chords.bindings.iter().any(|chord| {
+ chord.action.context == KeymapContext::List
+ && chord.chord.prefix == *binding
+ })
+ });
+ }
+ }
+
let mut resolved = Self {
app,
chords,
@@ -1067,6 +1142,7 @@ impl RuntimeKeymap {
vim_text_object,
pager,
list,
+ agents,
approval,
};
@@ -1095,6 +1171,7 @@ impl RuntimeKeymap {
fn built_in_defaults() -> Self {
Self {
app: AppKeymap {
+ open_agents: default_bindings![alt(KeyCode::Char('a'))],
open_transcript: default_bindings![ctrl(KeyCode::Char('t'))],
open_external_editor: default_bindings![ctrl(KeyCode::Char('g'))],
copy: default_bindings![ctrl(KeyCode::Char('o'))],
@@ -1323,6 +1400,14 @@ impl RuntimeKeymap {
cancel: default_bindings![plain(KeyCode::Esc)],
chord_hints: Arc::default(),
},
+ agents: AgentsKeymap {
+ search: default_bindings![ctrl(KeyCode::Char('f'))],
+ new_task: default_bindings![ctrl(KeyCode::Char('n'))],
+ rename: default_bindings![ctrl(KeyCode::Char('r'))],
+ stop: default_bindings![ctrl(KeyCode::Char('x'))],
+ toggle_grouping: default_bindings![ctrl(KeyCode::Char('s'))],
+ chord_hints: Arc::default(),
+ },
approval: ApprovalKeymap {
open_fullscreen: default_bindings![
ctrl(KeyCode::Char('a')),
@@ -1353,6 +1438,25 @@ impl RuntimeKeymap {
/// 2. Contexts with hard-coded sequence behavior, such as edit-previous
/// backtracking, intentionally stay outside this configurable keymap.
fn validate_conflicts(&self) -> Result<(), String> {
+ #[cfg(unix)]
+ if self
+ .app
+ .open_agents
+ .contains(&key_hint::ctrl(KeyCode::Char('z')))
+ {
+ return Err(
+ "tui.keymap.global.open_agents: ctrl-z is reserved for suspend".to_string(),
+ );
+ }
+ if self.app.open_agents.iter().any(|binding| {
+ matches!(binding.parts(), (KeyCode::Char(_), modifiers)
+ if crate::key_hint::is_altgr(modifiers))
+ }) {
+ return Err(
+ "tui.keymap.global.open_agents: AltGr characters are reserved for text input"
+ .to_string(),
+ );
+ }
let mut side_toggle_bindings = self.app.toggle_side_conversation.clone();
let slash_binding = key_hint::ctrl(KeyCode::Char('/'));
let legacy_slash_binding = key_hint::ctrl(KeyCode::Char('7'));
@@ -1365,6 +1469,7 @@ impl RuntimeKeymap {
validate_unique(
"app",
[
+ ("open_agents", self.app.open_agents.as_slice()),
("open_transcript", self.app.open_transcript.as_slice()),
(
"open_external_editor",
@@ -1409,6 +1514,7 @@ impl RuntimeKeymap {
validate_no_reserved(
"main",
[
+ ("open_agents", self.app.open_agents.as_slice()),
("open_transcript", self.app.open_transcript.as_slice()),
(
"open_external_editor",
@@ -1459,6 +1565,7 @@ impl RuntimeKeymap {
validate_no_shadow_with_allowed_overlaps(
"app",
[
+ ("open_agents", self.app.open_agents.as_slice()),
("open_transcript", self.app.open_transcript.as_slice()),
(
"open_external_editor",
@@ -1524,6 +1631,7 @@ impl RuntimeKeymap {
validate_no_shadow_with_allowed_overlaps(
"main",
[
+ ("open_agents", self.app.open_agents.as_slice()),
("open_transcript", self.app.open_transcript.as_slice()),
(
"open_external_editor",
@@ -1817,6 +1925,35 @@ impl RuntimeKeymap {
],
)?;
+ let agents_bindings = [
+ ("search", self.agents.search.as_slice()),
+ ("new_task", self.agents.new_task.as_slice()),
+ ("rename", self.agents.rename.as_slice()),
+ ("stop", self.agents.stop.as_slice()),
+ ("toggle_grouping", self.agents.toggle_grouping.as_slice()),
+ ];
+ validate_unique("agents", agents_bindings)?;
+ validate_no_reserved("agents", agents_bindings, MAIN_RESERVED_BINDINGS, [])?;
+ for (action, bindings) in agents_bindings {
+ #[cfg(unix)]
+ if bindings.contains(&key_hint::ctrl(KeyCode::Char('z'))) {
+ return Err(format!(
+ "tui.keymap.agents.{action}: ctrl-z is reserved for suspend"
+ ));
+ }
+ if bindings.iter().any(|binding| {
+ matches!(binding.parts(), (KeyCode::Char(_), modifiers)
+ if modifiers.is_empty()
+ || modifiers == KeyModifiers::SHIFT
+ || crate::key_hint::is_altgr(modifiers))
+ || binding.parts() == (KeyCode::Backspace, KeyModifiers::NONE)
+ }) {
+ return Err(format!(
+ "tui.keymap.agents.{action}: printable keys and backspace are reserved for task input"
+ ));
+ }
+ }
+
validate_unique(
"approval",
[
@@ -2891,6 +3028,156 @@ mod tests {
expect_conflict(&keymap, "clear_terminal", "toggle_fast_mode");
}
+ #[test]
+ fn agents_overview_can_be_remapped_and_rejects_conflicts() {
+ let mut keymap = TuiKeymap::default();
+ keymap.global.open_agents = Some(one("f12"));
+ keymap.agents.search = Some(one("f6"));
+ keymap.agents.new_task = Some(one("f7"));
+ keymap.agents.rename = Some(one("f9"));
+ keymap.agents.stop = Some(one("f10"));
+ keymap.agents.toggle_grouping = Some(one("f8"));
+
+ let runtime = RuntimeKeymap::from_config(&keymap).expect("runtime keymap");
+ assert_eq!(
+ (
+ runtime.app.open_agents,
+ runtime.agents.search,
+ runtime.agents.new_task,
+ runtime.agents.rename,
+ runtime.agents.stop,
+ runtime.agents.toggle_grouping,
+ ),
+ (
+ vec![key_hint::plain(KeyCode::F(12))],
+ vec![key_hint::plain(KeyCode::F(6))],
+ vec![key_hint::plain(KeyCode::F(7))],
+ vec![key_hint::plain(KeyCode::F(9))],
+ vec![key_hint::plain(KeyCode::F(10))],
+ vec![key_hint::plain(KeyCode::F(8))],
+ )
+ );
+
+ keymap.agents.toggle_grouping = Some(one("right"));
+ let runtime = RuntimeKeymap::from_config(&keymap).expect("runtime keymap");
+ assert!(
+ runtime
+ .list
+ .move_right
+ .contains(&key_hint::plain(KeyCode::Right))
+ );
+ keymap.agents.toggle_grouping = Some(one("f8"));
+
+ keymap.agents.stop = Some(one("f9"));
+ expect_conflict(&keymap, "rename", "stop");
+
+ keymap.agents.stop = Some(one("f10"));
+ keymap.global.open_agents = Some(one("ctrl-t"));
+ expect_conflict(&keymap, "open_agents", "open_transcript");
+
+ keymap.global.open_agents = Some(one("f12"));
+ keymap.agents.stop = Some(one("ctrl-c"));
+ expect_conflict(&keymap, "stop", "fixed.interrupt_or_quit");
+
+ #[cfg(unix)]
+ {
+ keymap.agents.stop = Some(one("ctrl-z"));
+ assert!(
+ RuntimeKeymap::from_config(&keymap)
+ .unwrap_err()
+ .contains("suspend")
+ );
+ keymap.agents.stop = Some(one("f10"));
+ keymap.global.open_agents = Some(one("ctrl-z"));
+ assert!(
+ RuntimeKeymap::from_config(&keymap)
+ .unwrap_err()
+ .contains("suspend")
+ );
+ keymap.global.open_agents = Some(one("f12"));
+ }
+
+ keymap.agents.stop = Some(one("f10"));
+ keymap.agents.search = Some(one("right"));
+ let runtime =
+ RuntimeKeymap::from_config(&keymap).expect("dashboard shortcuts take priority");
+ assert_eq!(runtime.agents.search, vec![key_hint::plain(KeyCode::Right)]);
+ assert_eq!(
+ runtime.list.move_right,
+ RuntimeKeymap::defaults().list.move_right
+ );
+
+ keymap.agents.search = None;
+ keymap.agents.rename = None;
+ keymap.list.move_right = Some(one("ctrl-r"));
+ let runtime = RuntimeKeymap::from_config(&keymap).expect("list shortcut remains usable");
+ assert_eq!(
+ runtime.agents.rename,
+ vec![key_hint::ctrl(KeyCode::Char('r'))]
+ );
+
+ keymap.agents.search = Some(one("s"));
+ assert!(
+ RuntimeKeymap::from_config(&keymap)
+ .expect_err("printable shortcut is reserved for input")
+ .contains("printable keys")
+ );
+
+ keymap.agents.search = None;
+ keymap.agents.stop = Some(one("backspace"));
+ assert!(
+ RuntimeKeymap::from_config(&keymap)
+ .expect_err("backspace is reserved for task input")
+ .contains("backspace")
+ );
+
+ #[cfg(windows)]
+ {
+ keymap.agents.stop = Some(one("ctrl-alt-@"));
+ assert!(RuntimeKeymap::from_config(&keymap).is_err());
+ keymap.agents.stop = Some(one("f10"));
+ keymap.global.open_agents = Some(one("ctrl-alt-@"));
+ assert!(
+ RuntimeKeymap::from_config(&keymap)
+ .unwrap_err()
+ .contains("AltGr")
+ );
+ keymap.global.open_agents = Some(one("f12"));
+ }
+ keymap.agents.stop = Some(one("backspace f10"));
+ assert!(
+ RuntimeKeymap::from_config(&keymap)
+ .expect_err("backspace is reserved for task input")
+ .contains("backspace")
+ );
+ }
+
+ #[test]
+ fn agents_overview_default_yields_to_existing_custom_shortcuts() {
+ let mut keymap = TuiKeymap::default();
+ keymap.global.open_transcript = Some(one("alt-a"));
+
+ let runtime = RuntimeKeymap::from_config(&keymap).expect("existing keymap remains valid");
+
+ assert_eq!(
+ runtime.app.open_transcript,
+ vec![key_hint::alt(KeyCode::Char('a'))]
+ );
+ assert!(runtime.app.open_agents.is_empty());
+
+ keymap.global.open_transcript = Some(one("alt-a ctrl-t"));
+ let runtime = RuntimeKeymap::from_config(&keymap).expect("existing chord remains valid");
+ assert!(runtime.app.open_agents.is_empty());
+
+ keymap.global.open_transcript = None;
+ keymap.pager.scroll_up = Some(one("alt-a page-up"));
+ let runtime = RuntimeKeymap::from_config(&keymap).expect("pager chord remains valid");
+ assert_eq!(
+ runtime.app.open_agents,
+ vec![key_hint::alt(KeyCode::Char('a'))]
+ );
+ }
+
#[test]
fn toggle_side_conversation_can_be_remapped_and_rejects_conflicts() {
let mut keymap = TuiKeymap::default();
diff --git a/codex-rs/tui/src/keymap/bindings.rs b/codex-rs/tui/src/keymap/bindings.rs
index b256753da3..87ab9dc580 100644
--- a/codex-rs/tui/src/keymap/bindings.rs
+++ b/codex-rs/tui/src/keymap/bindings.rs
@@ -22,6 +22,7 @@ pub(crate) enum KeymapContext {
VimTextObject,
Pager,
List,
+ Agents,
Approval,
}
@@ -37,6 +38,7 @@ impl KeymapContext {
Self::VimTextObject => "vim_text_object",
Self::Pager => "pager",
Self::List => "list",
+ Self::Agents => "agents",
Self::Approval => "approval",
}
}
@@ -57,6 +59,8 @@ impl KeymapContext {
(self, other),
(Self::List, Self::Approval)
| (Self::Approval, Self::List)
+ | (Self::List, Self::Agents)
+ | (Self::Agents, Self::List)
| (Self::Chat, Self::List)
| (Self::List, Self::Chat)
) || self.is_shared_main() && other.is_main_editor()
@@ -221,6 +225,7 @@ macro_rules! define_runtime_action_bindings {
define_runtime_action_bindings! {
"global" => Global, app, global [
+ open_agents,
open_transcript,
open_external_editor,
copy,
@@ -340,6 +345,13 @@ define_runtime_action_bindings! {
accept,
cancel,
],
+ "agents" => Agents, agents, agents [
+ search,
+ new_task,
+ rename,
+ stop,
+ toggle_grouping,
+ ],
"approval" => Approval, approval, approval [
open_fullscreen,
open_thread,
diff --git a/codex-rs/tui/src/keymap/chords.rs b/codex-rs/tui/src/keymap/chords.rs
index 22902aaee2..35e4105dd9 100644
--- a/codex-rs/tui/src/keymap/chords.rs
+++ b/codex-rs/tui/src/keymap/chords.rs
@@ -67,6 +67,7 @@ const fn context_bit(context: KeymapContext) -> u16 {
KeymapContext::Pager => 7,
KeymapContext::List => 8,
KeymapContext::Approval => 9,
+ KeymapContext::Agents => 10,
}
}
@@ -441,6 +442,15 @@ fn validate_reserved_strokes(binding: &RuntimeChordBinding) -> Result<(), String
));
}
+ if binding.action.context == KeymapContext::Agents
+ && binding.chord.prefix.parts() == (KeyCode::Backspace, KeyModifiers::NONE)
+ {
+ return Err(format!(
+ "Invalid `{path}` = `{}`: `backspace` is reserved for editing task input.",
+ binding.spec
+ ));
+ }
+
#[cfg(unix)]
if strokes.contains(&crate::key_hint::ctrl(KeyCode::Char('z')).parts()) {
return Err(format!(
@@ -460,7 +470,7 @@ Choose a different chord and retry.",
| KeymapContext::VimOperator
| KeymapContext::VimTextObject => MAIN_RESERVED_BINDINGS,
KeymapContext::List => LIST_RESERVED_BINDINGS,
- KeymapContext::Approval => &LIST_RESERVED_BINDINGS[..1],
+ KeymapContext::Agents | KeymapContext::Approval => &LIST_RESERVED_BINDINGS[..1],
};
if let Some((reserved_action, _)) = reserved.iter().find(|(_, reserved)| {
binding.chord.prefix.parts() == reserved.parts()
diff --git a/codex-rs/tui/src/keymap_setup.rs b/codex-rs/tui/src/keymap_setup.rs
index e6737249b2..0b7da69d77 100644
--- a/codex-rs/tui/src/keymap_setup.rs
+++ b/codex-rs/tui/src/keymap_setup.rs
@@ -986,7 +986,6 @@ mod tests {
.join(".")
})
.collect::<Vec<_>>();
-
assert_eq!(
actions,
vec![
diff --git a/codex-rs/tui/src/keymap_setup/actions.rs b/codex-rs/tui/src/keymap_setup/actions.rs
index f47422d8b5..0f73b6bb41 100644
--- a/codex-rs/tui/src/keymap_setup/actions.rs
+++ b/codex-rs/tui/src/keymap_setup/actions.rs
@@ -84,6 +84,7 @@ impl KeymapActionDescriptor {
#[rustfmt::skip]
pub(super) const KEYMAP_ACTIONS: &[KeymapActionDescriptor] = &[
+ action("global", "Global", "open_agents", "Open the shared agent-session overview."),
action("global", "Global", "open_transcript", "Open the transcript overlay."),
action("global", "Global", "open_external_editor", "Open the current draft in an external editor."),
action("global", "Global", "copy", "Copy the last agent response to the clipboard."),
@@ -186,6 +187,11 @@ pub(super) const KEYMAP_ACTIONS: &[KeymapActionDescriptor] = &[
action("list", "List", "jump_bottom", "Jump to the last list item."),
action("list", "List", "accept", "Accept the current list selection."),
action("list", "List", "cancel", "Cancel and close selection views."),
+ action("agents", "Agents", "search", "Search the available agent tasks."),
+ action("agents", "Agents", "new_task", "Start composing a new agent task."),
+ action("agents", "Agents", "rename", "Rename the selected task."),
+ action("agents", "Agents", "stop", "Stop the selected running task."),
+ action("agents", "Agents", "toggle_grouping", "Group tasks by status or project."),
action("approval", "Approval", "open_fullscreen", "Open approval details fullscreen."),
action("approval", "Approval", "open_thread", "Open the approval source thread when available."),
action("approval", "Approval", "approve", "Approve the primary option."),
@@ -228,6 +234,7 @@ pub(super) fn binding_slot<'a>(
action: &str,
) -> Option<&'a mut Option<KeybindingsSpec>> {
match (context, action) {
+ ("global", "open_agents") => Some(&mut keymap.global.open_agents),
("global", "open_transcript") => Some(&mut keymap.global.open_transcript),
("global", "open_external_editor") => Some(&mut keymap.global.open_external_editor),
("global", "copy") => Some(&mut keymap.global.copy),
@@ -330,6 +337,11 @@ pub(super) fn binding_slot<'a>(
("list", "jump_bottom") => Some(&mut keymap.list.jump_bottom),
("list", "accept") => Some(&mut keymap.list.accept),
("list", "cancel") => Some(&mut keymap.list.cancel),
+ ("agents", "search") => Some(&mut keymap.agents.search),
+ ("agents", "new_task") => Some(&mut keymap.agents.new_task),
+ ("agents", "rename") => Some(&mut keymap.agents.rename),
+ ("agents", "stop") => Some(&mut keymap.agents.stop),
+ ("agents", "toggle_grouping") => Some(&mut keymap.agents.toggle_grouping),
("approval", "open_fullscreen") => Some(&mut keymap.approval.open_fullscreen),
("approval", "open_thread") => Some(&mut keymap.approval.open_thread),
("approval", "approve") => Some(&mut keymap.approval.approve),
diff --git a/codex-rs/tui/src/keymap_setup/picker.rs b/codex-rs/tui/src/keymap_setup/picker.rs
index b062b865cc..54c971c2d1 100644
--- a/codex-rs/tui/src/keymap_setup/picker.rs
+++ b/codex-rs/tui/src/keymap_setup/picker.rs
@@ -112,6 +112,12 @@ const KEYMAP_CONTEXT_TABS: &[KeymapContextTab] = &[
description: "Pager and selection-list navigation shortcuts.",
contexts: &["pager", "list"],
},
+ KeymapContextTab {
+ id: "agents-shortcuts",
+ label: "Agents",
+ description: "Shared agents dashboard shortcuts.",
+ contexts: &["agents"],
+ },
KeymapContextTab {
id: "approval-shortcuts",
label: "Approval",
diff --git a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_all_tab_search.snap b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_all_tab_search.snap
index 96b96403d7..ccdb70a0a2 100644
--- a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_all_tab_search.snap
+++ b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_all_tab_search.snap
@@ -2,6 +2,7 @@
source: tui/src/keymap_setup.rs
expression: snapshot
---
+Open Agents | alt-a | Global open_agents Open Agents Open the shared agent-session overview. alt-a Default
Open Transcript | ctrl-t | Global open_transcript Open Transcript Open the transcript overlay. ctrl-t Default
Open External Editor | ctrl-g | Global open_external_editor Open External Editor Open the current draft in an external editor. ctrl-g Default
Copy | ctrl-o | Global copy Copy Copy the last agent response to the clipboard. ctrl-o Default
@@ -13,4 +14,3 @@ Interrupt Turn | esc | Chat interrupt_turn Interrupt Turn Interrupt the active t
Decrease Reasoning Effort | alt-,, shift-down | Chat decrease_reasoning_effort Decrease Reasoning Effort Decrease reasoning effort. alt-,, shift-down Default
Increase Reasoning Effort | alt-., shift-up | Chat increase_reasoning_effort Increase Reasoning Effort Increase reasoning effort. alt-., shift-up Default
Edit Queued Message | alt-up, shift-left | Chat edit_queued_message Edit Queued Message Edit the most recently queued message. alt-up, shift-left Default
-Submit | enter | Composer submit Submit Submit the current composer draft. enter Default
diff --git a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_custom.snap b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_custom.snap
index 7332b06ead..18c52da0df 100644
--- a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_custom.snap
+++ b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_custom.snap
@@ -5,18 +5,18 @@ expression: "render_picker(params, 120)"
Keymap
All configurable shortcuts.
- 109 actions, 1 customized, 2 unbound.
+ 115 actions, 1 customized, 2 unbound.
- [All] Common Customized (1) Unbound (2) App Composer Editor Vim Navigation Approval Debug
+ [All] Common Customized (1) Unbound (2) App Composer Editor Vim Navigation Agents Approval Debug
Type to search shortcuts
-› Global Open Transcript ctrl-t
+› Global Open Agents alt-a
+ Global Open Transcript ctrl-t
Global Open External Editor ctrl-g
Global Copy ctrl-o
Global Clear Terminal ctrl-l
Global - Toggle Vim Mode unbound
Global Toggle Raw Output alt-r
Global Toggle Side Conversation ctrl-/
- Chat Interrupt Turn esc
left/right group · enter edit shortcut · * custom · - unbound · esc close
diff --git a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_fast_mode_enabled.snap b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_fast_mode_enabled.snap
index 083b5812e2..cc8aefe0c0 100644
--- a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_fast_mode_enabled.snap
+++ b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_fast_mode_enabled.snap
@@ -5,18 +5,18 @@ expression: "render_picker(params, 120)"
Keymap
All configurable shortcuts.
- 110 actions, 0 customized, 3 unbound.
+ 116 actions, 0 customized, 3 unbound.
- [All] Common Customized (0) Unbound (3) App Composer Editor Vim Navigation Approval Debug
+ [All] Common Customized (0) Unbound (3) App Composer Editor Vim Navigation Agents Approval Debug
Type to search shortcuts
-› Global Open Transcript ctrl-t
+› Global Open Agents alt-a
+ Global Open Transcript ctrl-t
Global Open External Editor ctrl-g
Global Copy ctrl-o
Global Clear Terminal ctrl-l
Global - Toggle Vim Mode unbound
Global - Toggle Fast Mode unbound
Global Toggle Raw Output alt-r
- Global Toggle Side Conversation ctrl-/
left/right group · enter edit shortcut · * custom · - unbound · esc close
diff --git a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_first_actions.snap b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_first_actions.snap
index b38e163496..8de488ce44 100644
--- a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_first_actions.snap
+++ b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_first_actions.snap
@@ -2,17 +2,19 @@
source: tui/src/keymap_setup.rs
expression: snapshot
---
-tab: All (109 selectable)
+tab: All (115 selectable)
tab: Common (20 selectable)
tab: Customized (0) (0 selectable)
tab: Unbound (2) (2 selectable)
-tab: App (11 selectable)
+tab: App (12 selectable)
tab: Composer (5 selectable)
tab: Editor (17 selectable)
tab: Vim (48 selectable)
tab: Navigation (20 selectable)
+tab: Agents (5 selectable)
tab: Approval (8 selectable)
tab: Debug (1 selectable)
+Open Agents | alt-a | Global open_agents Open Agents Open the shared agent-session overview. alt-a Default
Open Transcript | ctrl-t | Global open_transcript Open Transcript Open the transcript overlay. ctrl-t Default
Open External Editor | ctrl-g | Global open_external_editor Open External Editor Open the current draft in an external editor. ctrl-g Default
Copy | ctrl-o | Global copy Copy Copy the last agent response to the clipboard. ctrl-o Default
@@ -24,4 +26,3 @@ Interrupt Turn | esc | Chat interrupt_turn Interrupt Turn Interrupt the active t
Decrease Reasoning Effort | alt-,, shift-down | Chat decrease_reasoning_effort Decrease Reasoning Effort Decrease reasoning effort. alt-,, shift-down Default
Increase Reasoning Effort | alt-., shift-up | Chat increase_reasoning_effort Increase Reasoning Effort Increase reasoning effort. alt-., shift-up Default
Edit Queued Message | alt-up, shift-left | Chat edit_queued_message Edit Queued Message Edit the most recently queued message. alt-up, shift-left Default
-Submit | enter | Composer submit Submit Submit the current composer draft. enter Default
diff --git a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_global_chord.snap b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_global_chord.snap
index 534fb4765d..482a6b4ea0 100644
--- a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_global_chord.snap
+++ b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_global_chord.snap
@@ -5,18 +5,18 @@ expression: "render_picker(params, 120)"
Keymap
All configurable shortcuts.
- 109 actions, 1 customized, 2 unbound.
+ 115 actions, 1 customized, 2 unbound.
- [All] Common Customized (1) Unbound (2) App Composer Editor Vim Navigation Approval Debug
+ [All] Common Customized (1) Unbound (2) App Composer Editor Vim Navigation Agents Approval Debug
Type to search shortcuts
-› Global * Open Transcript ctrl-t, ctrl-x ctrl-t
+› Global Open Agents alt-a
+ Global * Open Transcript ctrl-t, ctrl-x ctrl-t
Global Open External Editor ctrl-g
Global Copy ctrl-o
Global Clear Terminal ctrl-l
Global - Toggle Vim Mode unbound
Global Toggle Raw Output alt-r
Global Toggle Side Conversation ctrl-/
- Chat Interrupt Turn esc
left/right group · enter edit shortcut · * custom · - unbound · esc close
diff --git a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_narrow.snap b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_narrow.snap
index a389ef1ebe..dfcd60c0ee 100644
--- a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_narrow.snap
+++ b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_narrow.snap
@@ -5,19 +5,19 @@ expression: "render_picker(params, 78)"
Keymap
All configurable shortcuts.
- 109 actions, 0 customized, 2 unbound.
+ 115 actions, 0 customized, 2 unbound.
[All] Common Customized (0) Unbound (2) App Composer Editor Vim
- Navigation Approval Debug
+ Navigation Agents Approval Debug
Type to search shortcuts
-› Global Open Transcript ctrl-t
+› Global Open Agents alt-a
+ Global Open Transcript ctrl-t
Global Open External Editor ctrl-g
Global Copy ctrl-o
Global Clear Terminal ctrl-l
Global - Toggle Vim Mode unbound
Global Toggle Raw Output alt-r
Global Toggle Side Conversation ctrl-/
- Chat Interrupt Turn esc
left/right group · enter edit shortcut · * custom · - unbound · esc close
diff --git a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_wide.snap b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_wide.snap
index 4ccc5e4871..afa453bea6 100644
--- a/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_wide.snap
+++ b/codex-rs/tui/src/snapshots/codex_tui__keymap_setup__tests__keymap_picker_wide.snap
@@ -5,18 +5,18 @@ expression: "render_picker(params, 120)"
Keymap
All configurable shortcuts.
- 109 actions, 0 customized, 2 unbound.
+ 115 actions, 0 customized, 2 unbound.
- [All] Common Customized (0) Unbound (2) App Composer Editor Vim Navigation Approval Debug
+ [All] Common Customized (0) Unbound (2) App Composer Editor Vim Navigation Agents Approval Debug
Type to search shortcuts
-› Global Open Transcript ctrl-t
+› Global Open Agents alt-a
+ Global Open Transcript ctrl-t
Global Open External Editor ctrl-g
Global Copy ctrl-o
Global Clear Terminal ctrl-l
Global - Toggle Vim Mode unbound
Global Toggle Raw Output alt-r
Global Toggle Side Conversation ctrl-/
- Chat Interrupt Turn esc
left/right group · enter edit shortcut · * custom · - unbound · esc close