Questlog - Macdara Ó Murchú

This plugin scratches an itch I’ve had for months.

If you ever find yourself losing track of your session’s progress, or coming back in the morning having forgotten where you’d left off the night before, then this might be useful to you.

VS Code with an empty Claude Code chat. The prompt box, outlined in yellow, reads: Add a checkout flow to the cart: shipping, a checkout form, tests and a README note.

The bottom-left corner of VS Code with the hover card open above the Questlog item: Checkout flow for cart at 3 of 5, the five steps, demo-shop on feat/checkout, the folder, and the session ID with Copy and Show panel links.

#What it is

Questlog is two parts. The mod (a Claude Code plugin) gives Claude a questlog tool, sets the tab title, shows a status line, toasts each finished step, and adds /sessions and /questlog. The VS Code extension adds the sidebar and the status bar item. The mod works without the extension; the extension shows nothing without the mod.

#Install

Claude Code plugin

claude plugin marketplace add m4cd4r4/questlog
claude plugin install questlog@questlog

VS Code extension

code --install-extension macdara.questlog

VS Code Marketplace · Open VSX (VSCodium, Cursor)

#What you’ll see first

Start a new Claude Code session and give it a task with 3 or more steps, such as “Add a checkout flow with tests and a README note”. A card shows up in the Questlog sidebar with the plan and ticks off each step. A quick question won’t make a card.

#Why not Claude Code’s own session list?

Claude Code can already list your running sessions and tell you if one is waiting (claude agents). Questlog adds what each one is doing: its plan, the step it’s on, and how far it has got. A session you leave unfinished stays in the sidebar for up to 7 days, with a play button to open it again.

#How it’s built

A diagram of how Questlog is built. The Claude Code plugin has a questlog tool that Claude calls with a plan and step list, plus hooks and the /sessions and /questlog commands that react to Claude's events. The plugin runs git to find the repository and branch, sets the tab title and status line, and writes one row per session to a shared state folder at ~/.claude/questlog/. The VS Code extension watches that folder through a row reader and draws a sessions sidebar and a status bar item with a hover card. The reader also polls claude agents --json for live status and optionally reads a worktree registry. It writes card closes and panel toggles back to the folder, and the sidebar asks the Claude Code extension to reopen a session. Nothing leaves the machine.

#What it reads and sends

Reads and writes ~/.claude/questlog/. Runs git in the session’s directory to find the repo and branch. The extension also runs claude agents --json and reads the worktree registry if one exists. Neither part makes a network request itself.