prompt-rail

prompt-rail

A rail of your prompts for Claude Code. Hover to read one, click to jump back to it.

Quick start

prompt-rail is a mod, so it needs Claude Code 2.1.287 or later, where mods are on by default. If you set CLAUDE_CODE_ENABLE_FUNCTION_HOOKS during early access, you can remove it, since Claude Code now ignores it.

1. Install, from your shell or inside a session:

2. Start a new session. The rail opens on its own.

Mouse works best with "tui": "fullscreen".

Three layouts

Horizontal, above the prompt (default)

Vertical, beside the transcript

Below, under the prompt

The bars sit on a row of their own under the hint line below the prompt input, next to the status line, with the prompt being read beside them. ‹ and › step to the previous or next prompt. The hint line above them is Claude Code's own, so its mode label and hints stay as they are.

The below layout in motion

Commands

The layout is also the "Rail mode" row in /config, and it is kept across sessions. Switching it with /prompt-rail  also draws where the rail now sits around the prompt input.

Keyboard

Bind the step commands in ~/.claude/keybindings.json; they run mid-turn too:

In the horizontal layout, ctrl+x tab moves the focus to the bars: the ring starts on the prompt you are reading, ← → move it across the bars on screen and show its prompt, Enter jumps there, Esc returns to the prompt input.

Tick legend

How it works

From the transcript file to the rail

The rail lists the prompts of the live branch, so prompts abandoned with /rewind drop out, and prompts from before a resume are listed too. The prompt you are reading owns the topmost row on screen. The transcript is read again only when its size or time changed.

Limitations

Known limits

- The mods API may still change between Claude…