Skip to content

feat(keymap): add option to disable command mode on Escape#9907

Draft
ameenalkhaldi wants to merge 1 commit into
marimo-team:mainfrom
ameenalkhaldi:feat/disable-command-mode-escape
Draft

feat(keymap): add option to disable command mode on Escape#9907
ameenalkhaldi wants to merge 1 commit into
marimo-team:mainfrom
ameenalkhaldi:feat/disable-command-mode-escape

Conversation

@ameenalkhaldi

@ameenalkhaldi ameenalkhaldi commented Jun 17, 2026

Copy link
Copy Markdown

This pull request was authored by a coding agent.

Summary

Adds a new enter_command_mode_on_escape configuration option to the keymap settings, allowing users to disable the Escape key from entering command mode in the cell editor.

This addresses the issue where users' muscle memory expects Escape to clear hint popups (like autocomplete or signature help) rather than navigate to command mode.

Changes

  • Added enter_command_mode_on_escape: NotRequired[bool] to backend KeymapConfig in marimo/_config/config.py
  • Added corresponding field to frontend config schema in config-schema.ts
  • Updated navigation logic in navigation.ts to respect the config option
  • Regenerated OpenAPI spec and TypeScript types

Usage

Users can set this in their marimo config (e.g., ~/.marimo.toml):

[keymap]
enter_command_mode_on_escape = false

Default is true (existing behavior preserved).

Test plan

  • Backend config tests pass (pytest tests/_config/)
  • Frontend typecheck passes (make fe-typecheck)
  • Python checks pass (make py-check)
  • OpenAPI codegen successful (make fe-codegen)

Closes #7426

Review in cubic

Add `enter_command_mode_on_escape` config option to allow users to
disable the Escape key from entering command mode in the cell editor.

This is useful for users whose muscle memory expects Escape to clear
hint popups rather than navigate to command mode.

Closes marimo-team#7426
@vercel

vercel Bot commented Jun 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
marimo-docs Ready Ready Preview, Comment Jun 17, 2026 11:24am

Request Review

@github-actions github-actions Bot added the bash-focus Area to focus on during release bug bash label Jun 17, 2026
@github-actions

Copy link
Copy Markdown


Thank you for your submission, we really appreciate it. Like many open-source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution. You can sign the CLA by just posting a Pull Request Comment same as the below format.


I have read the CLA Document and I hereby sign the CLA


You can retrigger this bot by commenting recheck in this Pull Request. Posted by the CLA Assistant Lite bot.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bash-focus Area to focus on during release bug bash

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Option to disable command mode or change key binding

1 participant