prompt-rail plugin

A prompt rail for Claude Code: hover to read a prompt, click to jump back, with three layouts and commands

  • 66 ★ on the repository
  • Last commit
Plugin

Minimal access

Why this level

  • The mod reads the current session transcript file on your machine and draws the rail from it
  • The mod adds a rail and commands to the Claude Code interface, and the docs describe no other actions
All reasons and checks

oikon48/prompt-rail

Install

Works in

In your terminal, with SkillFoxx CLI

npx skillfoxx add plugins/prompt-rail

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The mod reads the current session transcript file on your machine and draws the rail from it
  • The mod adds a rail and commands to the Claude Code interface, and the docs describe no other actions

This is third-party code. Review the repository files before installing.

What it does

prompt-rail is a Claude Code mod that draws a rail of your prompts from the current session in the interface. Hover a tick to read the prompt and click it to scroll the conversation back there. It needs Claude Code 2.1.287 or newer, where mods are on by default. The mouse works best with `"tui": "fullscreen"`. There are three layouts: horizontal above the prompt input (the default), a vertical pane beside the transcript and a below layout under the hint line next to the status line. `/prompt-rail horizontal`, `vertical`, `below` or `off` switches the view, the choice persists across sessions and appears in `/config` as the "Rail mode" row. You can jump with `/prompt-rail next`, `prev`, `first`, `last`, by number such as `/prompt-rail 12` or by search with `/prompt-rail find <words>`. For keybindings there are `/prompt-rail-next`, `/prompt-rail-prev` and `/prompt-rail-toggle`, bound in `~/.claude/keybindings.json`. Ticks mark the prompt you are reading, other prompts and prompts that Claude Code refused to scroll to, which `next` and `prev` skip.

Who it is for. Claude Code users with long sessions who need to get back quickly to one of their earlier prompts.

Good fit when

  • A session holds nearly a hundred prompts and you need the one where you described the constraints
  • You want to jump to the previous prompt with a key chord such as Ctrl+K
  • You want a vertical prompt pane beside the conversation on a wide screen
  • You need to find a prompt by its words with `/prompt-rail find`

Not a fit when

  • You run a Claude Code older than 2.1.287, where mods are unavailable
  • You need search across all projects and sessions: the rail works inside one session
  • You work in another agent: the mod is written for Claude Code only

Example request

Jump to the prompt where I asked to rename the table with /prompt-rail find rename

Limitations

  • Claude Code 2.1.287 or newer is required. If you set `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS` during early access you can remove it, since Claude Code now ignores it.
  • The mouse works best with `"tui": "fullscreen"`; in other modes the rail is driven by commands and keys.
  • Claude Code sometimes refuses to scroll the conversation to a prompt; those ticks are dashed and `next` and `prev` skip them.
  • The rail is built from the session transcript file on your machine, so it sees only the current session.

How to disable. Remove the plugin with `claude plugin uninstall prompt-rail@oikon48`; `/prompt-rail off` only hides the rail for now.

FAQ

How do I install prompt-rail?

Run `claude plugin marketplace add oikon48/prompt-rail` and `claude plugin install prompt-rail@oikon48`. Inside a session `/plugin marketplace add` and `/plugin install` do the same. The rail appears in a new session.

How do I switch the layout?

With `/prompt-rail horizontal`, `vertical` or `below`, or in `/config` through the "Rail mode" row. The choice persists across sessions.

How do I bind keys?

In `~/.claude/keybindings.json` under the `Chat` context, bind keys to `command:prompt-rail-prev` and `command:prompt-rail-next`. They work mid-turn too.

What do the ticks mean?

A heavy tick is the prompt you are reading, a thin tick is any other prompt and a dashed tick is a prompt Claude Code refused to scroll to.

How does it work inside?

The mod reads the current session transcript, builds ticks from it and a click scrolls the conversation to the chosen prompt through Claude Code function hooks.

Discussion

No questions or reviews yet.

Plugins

claude-history searches and opens past Claude Code, Codex and Pi conversations in the terminal and gives Claude a history skill

CLIExtended access542Repository stars

A Claude Code panel for several projects: statuses, button decisions, Git, PR, CI and usage limits in one window.

PluginExtended access79Repository stars

Two plugins change how Claude Code output looks: replies in the glamour dark style and tool calls as compact one-liners.

PluginExtended access83Repository stars

A Claude Code plugin draws a band above the prompt with remaining 7-day and 5-hour limits and the prompt cache state

PluginMinimal access245Repository stars

Skill that reads your prompt history, finds the asks you repeat and turns each into a short command such as /sent

SkillExtended access134Repository stars

A Claude Code plugin that replaces auto-compact: it writes a handoff brief, clears the session and continues from it

PluginExtended access125Repository stars

README in short

The README shows the prompt rail, its three layouts, a command table, key bindings, a tick legend and a diagram from transcript file to drawing.

README badge

Report a problem