claude-code - 💡(How to fix) Fix Add configurable cursor style option (cursorStyle) for terminal cursor appearance

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…

Root Cause

Manually configuring the terminal — doesn't work because the TUI actively overrides it. Using a terminal wrapper script — fragile and not a real solution.

RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing requests and this feature hasn't been requested yet
  • This is a single feature request (not multiple features)

Problem Statement

When using Claude Code in Windows Terminal (or any modern terminal emulator), the cursor is forced to a block style upon entering the TUI, overriding the user's terminal cursor preference (e.g., line/beam/I-beam). After exiting Claude Code, the cursor reverts to the default terminal setting. This is jarring and reduces the native feel of the terminal experience.

Proposed Solution

Introduce a cursorStyle setting in settings.json that allows users to choose their preferred cursor shape within Claude Code:

{
  "cursorStyle": "line"
}

Supported values: "block", "line", "underline", or "terminal" (use the terminal's default without overriding).

This setting would control the ANSI escape sequences Claude Code emits for cursor shape (e.g., \e[5 q for beam, \e[1 q
 for block).

### Alternative Solutions

Manually configuring the terminal — doesn't work because the TUI actively overrides it.
Using a terminal wrapper script — fragile and not a real solution.

### Priority

Critical - Blocking my work

### Feature Category

CLI commands and flags

### Use Case Example

_No response_

### Additional Context

Terminal: Windows Terminal
Platform: Windows 10
Many terminal users have a strong preference for beam/line cursors in text input contexts, and being forced to block mode feels off.

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