It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
Version
1.4.0
License
MIT
Repo stars
5
Last change
2026-10-16
What it can reach
Draws in the session
Reads this turn's file edits
Sees tool calls
Calls another program on this machine
It opens when an interactive session starts in a git repository that has TODOs. The scan runs after the session starts, so it never holds the first prompt. It hides on the next message, or on Hide. /todos scans again. show_on_start defaults to true, rows to 8, markers to TODO, FIXME, and HACK, and mine_only to false. Show Claude puts the picked TODOs in the prompt box under Read these TODOs:, and nothing runs until you send. Clear drops the picks. Mine keeps the TODOs whose git author is your user.email. Newest comes first, dated with git blame. A line not committed yet reads today. A security finding is bold red. Review findings puts every finding in the prompt box, security first. Findings are files under todos/findings/ in the git common directory, .git/todos/findings/ in a plain clone, so no commit carries them. The band lets a plain todos-finding call run where only the permission mode would ask, when the command is the name alone and its arguments are plain words. A settings rule or a hook that asks or denies keeps its say. TODO(#42) links to that issue when origin is on GitHub. When Claude edits a file with Edit or Write and adds a TODO, a toast names it. A title longer than 200 characters is cut. The list scrolls through the 500 newest TODOs and findings, and the footer counts the rest as +N more.
The install name is todos. This page adds the author's name. The marketplace name is bengous-plugins. The marketplace also holds secret-pane, pinpoint, and agent-hooks. This one installs on its own. The band of open TODOs is why this page files it under workflow. pin-memo pins notes and clickable todos above the prompt, and brings them back in the same session and folder. pinboard-sirkitree draws open decisions, the session's todos, and links Claude creates in a side pane so they stay in view. Nothing else on the shelf lists the repository's TODO comments above the prompt. git grep and git blame read the repository on this machine. The issue link opens in the browser.
Demo
Screenshot of the author's GitHub page.
What it hooks into
session.startWhen a session starts
classic.SessionStartA Claude Code event
prompt.submitWhen you send a prompt
command.runWhen you run its slash command
tool.callAround a tool call, where it can hold oneEditWriteBash
tool.checkA Claude Code eventBash
ui.scrollA Claude Code eventAbovePrompt
ui.renderDraws into the sessionAbovePrompt
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Files
The author's README and source, 7 files. They load when you open them.