codex - 💡(How to fix) Fix TUI Vim mode: allow starting in Insert mode by default

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Code Example

[tui]
vim_mode_default = true
vim_mode_initial_state = "insert"
RAW_BUFFERClick to expand / collapse

What variant of Codex are you using?

CLI

What feature would you like to see?

Please add an option for Vim mode to start in Insert mode by default, while still allowing users to press Esc to enter Normal mode.

Currently, enabling Vim mode permanently starts the composer in Normal mode. I would prefer a config option such as:

[tui]
vim_mode_default = true
vim_mode_initial_state = "insert"

or similar.

Motivation

Most TUI interactions begin with writing a new prompt, and only optionally editing that prompt afterward. Starting in Insert mode matches that common flow better while preserving Vim-style editing when needed. This would also match the behavior of “vi mode” in shells like Bash: the prompt starts ready for text input, and users can press Esc to switch into Normal mode for editing.

Related issue: #21804

Additional information

No response

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix TUI Vim mode: allow starting in Insert mode by default