
prompt-rail
A rail of your Claude Code session's prompts: hover to read, click to jump (function hooks / Mods)
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up prompt-rail (claude-plugin project) into my current project. Found on https://claudeers.com/prompt-rail Repo: https://github.com/oikon48/prompt-rail Homepage/docs: — Detected install method: claude-plugin → /plugin install prompt-rail@oikon48/prompt-rail Category: plugins. Platforms: cli, api, desktop. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
⚠ Unverified / not recently updated — review before pasting a run-this config.
/plugin marketplace add oikon48/prompt-rail /plugin install prompt-rail@oikon48/prompt-rail
git clone https://github.com/oikon48/prompt-rail
// compatibility
| Platforms | cli, api, desktop |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | TypeScript |
prompt-rail
A rail of your prompts for Claude Code. Hover to read one, click to jump back to it.
Quick start
-
Turn on function hooks (early access, Claude Code 2.1.280+) in
~/.claude/settings.json:{ "env": { "CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1" } } -
Install, from your shell or inside a session:
claude plugin marketplace add oikon48/prompt-rail claude plugin install prompt-rail@oikon48/plugin marketplace add oikon48/prompt-rail /plugin install prompt-rail@oikon48 -
Start a new session. The rail opens on its own.
Mouse works best with "tui": "fullscreen".
Two layouts
Horizontal, above the prompt (default)
Vertical, beside the transcript
Commands
| Command | |
|---|---|
/prompt-rail horizontal | Bars above the prompt input |
/prompt-rail vertical | A pane beside the transcript |
/prompt-rail off | Hide the rail |
/prompt-rail next | Jump to the next prompt |
/prompt-rail prev | Jump to the previous prompt |
/prompt-rail | Reopen the rail in the current layout |
The layout is also the "Rail mode" row in /config, and it is kept across sessions.
Tick legend
| Tick | Meaning |
|---|---|
━ ┃ | The prompt you are reading |
─ │ | Any other prompt |
┄ ┆ | A prompt Claude Code refused to scroll to; next and prev skip it |
How it works
From the transcript file to the rail
flowchart LR
T[transcript .jsonl] -->|every prompt on the live branch| R[rail]
S[rows on screen] -->|topmost row's prompt| R
R -->|click, next/prev| J[scroll that prompt's row into view]
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
- Function hooks are early access, and their API may change between Claude Code releases.
- The hover card with the turn summary is part of the horizontal rail; the terminal alone draws it.
- The Claude desktop app shows no rail. Checked with its bundled Claude Code 2.1.280, the engine reports the pane as placed, but the app never asks the plugin to draw it.
- The dock width is shared by all plugin panes; drag its edge to narrow it, down to 24 columns.
- A
/compactcommand's own row cannot be jumped to; its tick turns dotted after the first try. - Near the end of the transcript,
nextcannot scroll further.
Development
claude --plugin-dir plugins/prompt-rail # load this checkout; saving reloads it
claude plugin validate plugins/prompt-rail
claude plugin test plugins/prompt-rail
Run /plugin-types .claude/types in a session here for type declarations. Bump the version in plugins/prompt-rail/.claude-plugin/plugin.json with each release, since installed copies update only when it changes.
License
// faq
What is prompt-rail?
A rail of your Claude Code session's prompts: hover to read, click to jump (function hooks / Mods). It is open-source on GitHub.
Is prompt-rail free to use?
prompt-rail is open-source under the MIT license, so it is free to use.
What category does prompt-rail belong to?
prompt-rail is listed under plugins in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/prompt-rail)
// retro hit counter
[](https://claudeers.com/prompt-rail)
// reviews
// guestbook
// related in Claude Plugins
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…
"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
financial-services — a Claude ecosystem project on GitHub.