session-flags
A Claude Code mod that keeps what Claude flags during a session (questions, unfixed issues, warnings, follow-ups) in a side pane
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/dsebastien--session-flags)HTML
<a href="/listings/dsebastien--session-flags"><img src="/api/listings/dsebastien--session-flags/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.
Requires Claude Code v2.1.287 or later. Tested with v2.1.329.
Install it from the repository's own marketplace, in one step:
/plugin install session-flags --marketplace dsebastien/session-flags
Try it for one session:
git clone https://github.com/dsebastien/session-flags claude --plugin-dir ./session-flags
To load it in every session, add its absolute path to `CLAUDE_CODE_PLUGIN_DIRS` in the `env` block of `~/.claude/settings.json`.
The pane shows as a sidebar in a wide fullscreen terminal, and above the prompt otherwise.
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 · 17 lines
- {
- "name": "session-flags",
- "owner": {
- "name": "Sébastien Dubois",
- "url": "https://dsebastien.net"
- },
- "metadata": {
- "description": "Session Flags, a Claude Code mod that keeps what Claude flags during a session in a side pane."
- },
- "plugins": [
- {
- "name": "session-flags",
- "source": "./",
- "description": "A side pane that tracks what Claude flags during a session: questions, unfixed issues, warnings and follow-ups."
- }
- ]
- }
README.md · README · 129 lines
- # session-flags
- A [Claude Code mod](https://code.claude.com/docs/en/plugins/mods/overview) that keeps track of what Claude flags during a session: the questions it asks you, the issues it spots but doesn't fix, the warnings, and the follow-ups. They no longer get lost in the scrollback. They go into a side pane as a checklist that you can resolve, that cleans itself up, and that you can copy as markdown.
- Documentation: https://dsebastien.github.io/session-flags/
- ```text
- │ 2 open · 1 done
- │ c: copy a: copy all h: hide done q: close x: clear done
- │
- │ ? Questions
- │ ✓ ✕ ⧉ F3 Fix the two parser issues now, or just track them?
- │ ! Issues
- │ ✓ ✕ ⧉ F1 Race in cache invalidation
- │ src/cache.ts:42
- │ ↺ ⧉ F2 Missing null check (fixed with a test)
- │
- │ Add: note (start with ? ! ~ > for question, issue, warning, follow-up)
- ```
- ## How items get into the list
- - **Claude logs them itself.** The mod gives Claude three tools: `flag`, `resolve_flag` and `list_flags`. They're described so that Claude calls `flag` whenever it asks you something, notices a problem it isn't fixing, warns you about something, or leaves a follow-up. It calls `resolve_flag` once the item is settled. These are structured tool calls, so nothing depends on parsing prose. The tools never ask for permission.
- - **Trailing questions.** If Claude ends an answer with a question it didn't flag, the mod adds it to the list. Your next prompt counts as the answer and marks it handled. You can turn this off.
- - **Dismissed question dialogs.** If you dismiss one of Claude's `AskUserQuestion` dialogs without answering, its questions stay open in the list.
- - **You.** Type into the pane's field, or run `/flags add`. A leading `?`, `!`, `~` or `>` sets the kind: question, issue, warning or follow-up. Anything else is a note.
- Items are `open`, `handled` or `dismissed`. Handled and dismissed items fade, and are swept away 30 minutes after they were resolved by default.
- ## Keyboard and commands
- | What | How |
- | :- | :- |
- | Toggle the pane | `/flags`, or type `0` alone in an empty prompt, or a chord you bind (see below) |
- | Move around the pane | Tab, Up and Down, Enter to press. Ctrl+X Tab moves focus between the prompt, the band and the panes |
- | Copy open flags as markdown | `c` in the pane, or `/flags copy` |
- | Copy everything, including resolved flags | `a` in the pane, or `/flags copy all` |
- | Copy one flag | `⧉` on its row |
- | Resolve a flag | `✓` (handled) or `✕` (dismissed) on its row, or `/flags done F1 F2`, `/flags dismiss F3` |
- | Reopen a flag | `↺`, or `/flags reopen F1` |
- | Hide or show resolved flags | `h` |
- | Clear resolved flags | `x`, or `/flags clear`. `/flags clear all` clears everything |
- | Print the list in the transcript | `/flags list [all]` |
- | Close the pane | `q`, Esc, or Ctrl+X X |
- While the list holds flags, a badge such as `0: ⚑ 2 open flags` sits above the prompt. Press its digit to toggle the pane.
- ### A real shortcut
- A mod can't register a global key of its own, but its buttons can claim a chord bound to one of Claude Code's keybinding actions. session-flags uses `app:toggleDiffNoiseFilter` for this. That action is unbound by default, and Claude Code doesn't handle it while its built-in diff mod is enabled, which is the default. Bind a chord to it in `~/.claude/keybindings.json`:
- ```json
- {
- "bindings": [
- { "context": "Global", "bindings": { "ctrl+x f": "app:toggleDiffNoiseFilter" } }
- ]
- }
- ```
- Ctrl+X F then opens and closes the pane from the prompt. If you already use that action, set `toggleAction` to another free action (see Configuration).
- The chord reaches the mod only while the badge or the pane is on screen, which is whenever the list holds at least one flag. To open an empty list, use `/flags`.
- ## Install
- Requires Claude Code v2.1.287 or later. Tested with v2.1.329.
- Install it from the repository's own marketplace, in one step:
- ```text
- /plugin install session-flags --marketplace dsebastien/session-flags
- ```
- Try it for one session:
- ```bash
- git clone https://github.com/dsebastien/session-flags
- claude --plugin-dir ./session-flags
- ```
- To load it in every session, add its absolute path to `CLAUDE_CODE_PLUGIN_DIRS` in the `env` block of `~/.claude/settings.json`.
- The pane shows as a sidebar in a wide fullscreen terminal, and above the prompt otherwise.
- ## Configuration
- These are `userConfig` fields. For a `--plugin-dir` copy, set them under `pluginConfigs["session-flags@inline"]` in `~/.claude/settings.json` (`session-flags@session-flags` for a marketplace install).
- | Field | Default | What it does |
- | :- | :- | :- |
- | `bandHotkey` | `0` | Digit or letter on the badge. Digits also work when typed alone into an empty prompt. Empty disables it |
- | `toggleAction` | `app:toggleDiffNoiseFilter` | Keybinding action whose chord toggles the pane. Empty disables it |
- | `cleanupMinutes` | `30` | Minutes before handled and dismissed flags are swept. `0` keeps them until you clear them |
- | `captureTrailingQuestions` | `true` | Add the question Claude ends an answer with, if it didn't flag it |
- | `toastOnNewFlags` | `true` | Show a toast when flags arrive while the pane is closed |
- ## Storage
- The list belongs to a session. It's saved in the mod's `$.store`, under `~/.claude/plugins/store/`, so it survives reloads and comes back with `/resume`. Lists from sessions nobody has touched for 14 days are deleted.
- ## Develop
- ```bash
- claude plugin validate . # what Claude Code reads from the mod
- claude plugin test # the tests in tests/
- claude --plugin-dir . # live, with hot reload on save
- ```
- Claude Code writes type declarations for your version into `.claude-plugin/types/` when it loads the mod. `tsc -p . --noEmit` type-checks the tests against them.
- ## License
- MIT. See [LICENSE](LICENSE).
- ## News & support
- To stay up to date about this mod, Claude Code, AI, personal knowledge management and note-taking:
- - Subscribe to [my newsletter](https://dsebastien.net/newsletter)
- - Subscribe to [my YouTube channel](https://youtube.com/@dsebastien)
- - Join the [Knowii community](https://www.store.dsebastien.net/product/knowii-community/) and learn to organize your notes and put your knowledge to work, together with fellow knowledge workers
- If this mod is useful to you, here are the best ways to support my work ❤️:
- - [Join the Knowii community](https://www.store.dsebastien.net/product/knowii-community/)
- - [Become a GitHub Sponsor](https://github.com/sponsors/dsebastien)
- - [Buy me a coffee](https://www.buymeacoffee.com/dsebastien)
- - [Subscribe to my YouTube channel](https://youtube.com/@dsebastien)
- - [Check out my products](https://store.dsebastien.net)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.