Skip to content
Back to search

session-flags

MarketplaceWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dsebastien--session-flags/badge.svg)](/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
  1. {
  2. "name": "session-flags",
  3. "owner": {
  4. "name": "Sébastien Dubois",
  5. "url": "https://dsebastien.net"
  6. },
  7. "metadata": {
  8. "description": "Session Flags, a Claude Code mod that keeps what Claude flags during a session in a side pane."
  9. },
  10. "plugins": [
  11. {
  12. "name": "session-flags",
  13. "source": "./",
  14. "description": "A side pane that tracks what Claude flags during a session: questions, unfixed issues, warnings and follow-ups."
  15. }
  16. ]
  17. }
README.md · README · 129 lines
  1. # session-flags
  2. 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.
  3. Documentation: https://dsebastien.github.io/session-flags/
  4. ```text
  5. │ 2 open · 1 done
  6. │ c: copy a: copy all h: hide done q: close x: clear done
  7. │
  8. │ ? Questions
  9. │ ✓ ✕ ⧉ F3 Fix the two parser issues now, or just track them?
  10. │ ! Issues
  11. │ ✓ ✕ ⧉ F1 Race in cache invalidation
  12. │ src/cache.ts:42
  13. │ ↺ ⧉ F2 Missing null check (fixed with a test)
  14. │
  15. │ Add: note (start with ? ! ~ > for question, issue, warning, follow-up)
  16. ```
  17. ## How items get into the list
  18. - **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.
  19. - **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.
  20. - **Dismissed question dialogs.** If you dismiss one of Claude's `AskUserQuestion` dialogs without answering, its questions stay open in the list.
  21. - **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.
  22. Items are `open`, `handled` or `dismissed`. Handled and dismissed items fade, and are swept away 30 minutes after they were resolved by default.
  23. ## Keyboard and commands
  24. | What | How |
  25. | :- | :- |
  26. | Toggle the pane | `/flags`, or type `0` alone in an empty prompt, or a chord you bind (see below) |
  27. | Move around the pane | Tab, Up and Down, Enter to press. Ctrl+X Tab moves focus between the prompt, the band and the panes |
  28. | Copy open flags as markdown | `c` in the pane, or `/flags copy` |
  29. | Copy everything, including resolved flags | `a` in the pane, or `/flags copy all` |
  30. | Copy one flag | `⧉` on its row |
  31. | Resolve a flag | `✓` (handled) or `✕` (dismissed) on its row, or `/flags done F1 F2`, `/flags dismiss F3` |
  32. | Reopen a flag | `↺`, or `/flags reopen F1` |
  33. | Hide or show resolved flags | `h` |
  34. | Clear resolved flags | `x`, or `/flags clear`. `/flags clear all` clears everything |
  35. | Print the list in the transcript | `/flags list [all]` |
  36. | Close the pane | `q`, Esc, or Ctrl+X X |
  37. While the list holds flags, a badge such as `0: ⚑ 2 open flags` sits above the prompt. Press its digit to toggle the pane.
  38. ### A real shortcut
  39. 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`:
  40. ```json
  41. {
  42. "bindings": [
  43. { "context": "Global", "bindings": { "ctrl+x f": "app:toggleDiffNoiseFilter" } }
  44. ]
  45. }
  46. ```
  47. 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).
  48. 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`.
  49. ## Install
  50. Requires Claude Code v2.1.287 or later. Tested with v2.1.329.
  51. Install it from the repository's own marketplace, in one step:
  52. ```text
  53. /plugin install session-flags --marketplace dsebastien/session-flags
  54. ```
  55. Try it for one session:
  56. ```bash
  57. git clone https://github.com/dsebastien/session-flags
  58. claude --plugin-dir ./session-flags
  59. ```
  60. To load it in every session, add its absolute path to `CLAUDE_CODE_PLUGIN_DIRS` in the `env` block of `~/.claude/settings.json`.
  61. The pane shows as a sidebar in a wide fullscreen terminal, and above the prompt otherwise.
  62. ## Configuration
  63. 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).
  64. | Field | Default | What it does |
  65. | :- | :- | :- |
  66. | `bandHotkey` | `0` | Digit or letter on the badge. Digits also work when typed alone into an empty prompt. Empty disables it |
  67. | `toggleAction` | `app:toggleDiffNoiseFilter` | Keybinding action whose chord toggles the pane. Empty disables it |
  68. | `cleanupMinutes` | `30` | Minutes before handled and dismissed flags are swept. `0` keeps them until you clear them |
  69. | `captureTrailingQuestions` | `true` | Add the question Claude ends an answer with, if it didn't flag it |
  70. | `toastOnNewFlags` | `true` | Show a toast when flags arrive while the pane is closed |
  71. ## Storage
  72. 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.
  73. ## Develop
  74. ```bash
  75. claude plugin validate . # what Claude Code reads from the mod
  76. claude plugin test # the tests in tests/
  77. claude --plugin-dir . # live, with hot reload on save
  78. ```
  79. 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.
  80. ## License
  81. MIT. See [LICENSE](LICENSE).
  82. ## News & support
  83. To stay up to date about this mod, Claude Code, AI, personal knowledge management and note-taking:
  84. - Subscribe to [my newsletter](https://dsebastien.net/newsletter)
  85. - Subscribe to [my YouTube channel](https://youtube.com/@dsebastien)
  86. - 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
  87. If this mod is useful to you, here are the best ways to support my work ❤️:
  88. - [Join the Knowii community](https://www.store.dsebastien.net/product/knowii-community/)
  89. - [Become a GitHub Sponsor](https://github.com/sponsors/dsebastien)
  90. - [Buy me a coffee](https://www.buymeacoffee.com/dsebastien)
  91. - [Subscribe to my YouTube channel](https://youtube.com/@dsebastien)
  92. - [Check out my products](https://store.dsebastien.net)

Ratings and comments

Sign in to rate this skill.

Sign in

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