Skip to content
Back to search

tail-feed

MarketplaceWorks with Claude CodeGitHub

tail-feed, a Claude Code mod: a rail of the session's turns above the prompt input.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/stanlyzoolo--tail-feed/badge.svg)](/listings/stanlyzoolo--tail-feed)

HTML

<a href="/listings/stanlyzoolo--tail-feed"><img src="/api/listings/stanlyzoolo--tail-feed/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Needs Claude Code 2.1.325 or newer in a terminal in fullscreen rendering mode (`"tui": "fullscreen"` in settings), on macOS or Linux.

At the prompt of a Claude Code session:

/plugin install tail-feed --marketplace stanlyzoolo/tail-feed

From a shell it is `claude plugin install` with the same arguments. Answer `y` to `Add marketplace?` and pick a scope; the rail appears in that session right away, once the session has a prompt to show. The mod has no settings.

- Update: `claude plugin update tail-feed@tail-feed` - Remove: `claude plugin uninstall tail-feed@tail-feed`

A mod that draws the rows of your prompts itself (for example, prismantis) hides them from the mods under it, and the rail gets no bars. Put tail-feed above it in `~/.claude/settings.json`:

{
  "prependPlugins": ["tail-feed@tail-feed"]
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "tail-feed",
  3. "description": "tail-feed, a Claude Code mod: a rail of the session's turns above the prompt input.",
  4. "owner": { "name": "Vladimir Lepeshko" },
  5. "plugins": [
  6. {
  7. "name": "tail-feed",
  8. "source": "./",
  9. "description": "A rail of the session's turns above the prompt input: one bar per prompt, a click or a command jumps to it."
  10. }
  11. ]
  12. }
README.md · README · 140 lines
  1. # tail-feed
  2. A Claude Code mod: a rail of the session's turns above the prompt input. One bar per prompt shows what its turn did,
  3. and a click takes you back to it.
  4. https://github.com/user-attachments/assets/a6381775-2b42-4796-b414-e13f0d6f26e6
  5. Like `tail -f` on a log, each prompt lands as one new bar at the right end of the rail, and a glance at its shape tells
  6. you what the turn did. Unlike `tail -f`, every "line" is a way back: click a bar and the transcript scrolls to that
  7. prompt. In a long session that replaces scrolling for "where did I ask for this" and "after which prompt did the code
  8. change".
  9. ```text
  10. $ tail -f session.log [-] Feed · #7/7 ──────────────────────
  11. … ▂▂ ██ ▆▆ ▃▃ ▅▅ ▂▂▸██◂
  12. 12:04 edited 3 files #7 · edits: 3 files
  13. [Edit] rename the mod and fix the tests
  14. ```
  15. - **A row of bars** above the prompt input, one bar per human prompt in the session, oldest on the left, under a
  16. header with the place you are reading. `[-]` at the start of the header folds the rail to one row, `[+]` unfolds it.
  17. - **The bar's shape and colour** tell what happened in the turn after the prompt: files were edited, subagents ran, a
  18. skill worked, tools were called, or it was just talk. A turn with an error or an interruption is red.
  19. - **The card** under the bars shows the bar you are reading: its number, the turn summary, the kind name and the
  20. prompt text. Hovering another bar shows its card instead.
  21. - **A click** on a bar or the `/tail-feed` command scrolls the transcript to that prompt and marks it with a line
  22. `▸ #n/N · Kind` above it.
  23. ## Install
  24. Needs Claude Code 2.1.325 or newer in a terminal in fullscreen rendering mode (`"tui": "fullscreen"` in settings), on
  25. macOS or Linux.
  26. At the prompt of a Claude Code session:
  27. ```text
  28. /plugin install tail-feed --marketplace stanlyzoolo/tail-feed
  29. ```
  30. From a shell it is `claude plugin install` with the same arguments. Answer `y` to `Add marketplace?` and pick a
  31. scope; the rail appears in that session right away, once the session has a prompt to show. The mod has no settings.
  32. - Update: `claude plugin update tail-feed@tail-feed`
  33. - Remove: `claude plugin uninstall tail-feed@tail-feed`
  34. A mod that draws the rows of your prompts itself (for example, prismantis) hides them from the mods under it, and the
  35. rail gets no bars. Put tail-feed above it in `~/.claude/settings.json`:
  36. ```json
  37. {
  38. "prependPlugins": ["tail-feed@tail-feed"]
  39. }
  40. ```
  41. ## Reading the rail
  42. A bar sums up the turn after its prompt: everything the main agent did until the next prompt. The height is the kind
  43. of the turn, not the amount of work; the kind is the first matching row of the table.
  44. | Bar | Kind | Colour | When |
  45. | --- | --- | --- | --- |
  46. | `██` | `Edit` | green | files were edited |
  47. | `▆▆` | `Agent` | purple | subagents ran |
  48. | `▅▅` | `Skill` | yellow | the model called a skill |
  49. | `▃▃` | `Work` | blue | other tool calls: reads, searches, commands |
  50. | `▂▂` | `Talk` | grey | no tool calls |
  51. | `░░` | `Unknown` | dark grey | the turn is still running, or the prompt has no turn of its own |
  52. - **Red** instead of the kind's colour: the turn had an error (a failed tool call, a denied permission, an API error)
  53. or was interrupted with Esc.
  54. - **Cyan** means "you are here": the pointers `▸██◂` around the reading bar, `#n/N` in the header and the mark in the
  55. transcript. The reading bar is the bar of your last jump, or the newest one.
  56. - **`‹N` and `N›`** count the bars that do not fit the width on each side.
  57. ## Commands
  58. | Command | What it does |
  59. | --- | --- |
  60. | `/tail-feed` | one line: how many bars, which one you are reading, a hint on the arguments |
  61. | `/tail-feed next`, `prev` | jump to the next or previous prompt from the reading one |
  62. | `/tail-feed first`, `last` | jump to the first or last prompt of the rail |
  63. | `/tail-feed 12`, `/tail-feed #12` | jump to prompt #12: the same number as `#12` in the bar's card |
  64. | `/tail-feed find <words>` | jump to the newest prompt whose text has all the words |
  65. | `/tail-feed toggle` | fold the rail to one row or unfold it, as `[-]` and `[+]` do |
  66. | `/tail-feed-next`, `/tail-feed-prev`, `/tail-feed-toggle` | the same without an argument: for keys |
  67. Commands work while a turn is running too. To bind keys, add the commands without an argument to the `Chat` context
  68. of `~/.claude/keybindings.json`:
  69. ```json
  70. {
  71. "bindings": [
  72. {
  73. "context": "Chat",
  74. "bindings": {
  75. "ctrl+x p": "command:tail-feed-prev",
  76. "ctrl+x n": "command:tail-feed-next",
  77. "ctrl+x f": "command:tail-feed-toggle"
  78. }
  79. }
  80. ]
  81. }
  82. ```
  83. ## Limitations
  84. - **Fullscreen terminal only.** No rail on the main screen (`CLAUDE_CODE_NO_FLICKER=0`, tmux by default), in the
  85. desktop, VS Code and mobile apps, or while a subagent's transcript is open.
  86. - **After `claude --resume` bars appear as you scroll.** Claude Code draws transcript rows lazily, and only a drawn row
  87. gets a bar. Older turns are counted in `‹N` until you scroll up to them.
  88. - **Slash commands get no bars.** Neither do turns started by a notification, such as a finished background task.
  89. - **A prompt typed while a turn is running** and delivered into it stays a `░░` bar: its work is in the bar of the
  90. previous prompt. A prompt that waited for the turn to end gets its own bar as usual.
  91. - **The reading prompt follows jumps, not scrolling.** The wheel and PageUp do not move it; `next` and `prev` count
  92. from the bar of the last jump.
  93. Every part of the rail, the answers of the commands and the rest of the limitations are in
  94. [docs/reference.md](docs/reference.md).
  95. ## Development
  96. Run the mod from a checkout, for that session only (do not keep an installed copy enabled next to it):
  97. ```bash
  98. claude --plugin-dir /path/to/tail-feed
  99. ```
  100. The checks, from the repository root:
  101. ```bash
  102. claude plugin validate .
  103. claude plugin test .
  104. scripts/typecheck.sh
  105. ```
  106. How the code is built and the rules for changing it are in [CLAUDE.md](CLAUDE.md).
  107. ## License
  108. MIT, see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.