Skip to content

feat(commands): add /sidenote to park a thought without derailing the current task#19

Merged
pallaoro merged 2 commits into
mainfrom
sidenote-command-sometimes-i-think-about
Jul 17, 2026
Merged

feat(commands): add /sidenote to park a thought without derailing the current task#19
pallaoro merged 2 commits into
mainfrom
sidenote-command-sometimes-i-think-about

Conversation

@pallaoro

Copy link
Copy Markdown
Member

What

Adds a /sidenote slash command: a way to jot a passing thought mid-task without the agent treating it as a new request and rushing the current work to "get to" it.

The command reframes the queued message as a parked later-task, not a now-task:

  • Logs it verbatim to .claude/sidenotes.md (durable across compaction and session end — Claude Code has no native instruction-parking store to reuse).
  • One-line acknowledgement, then resumes with the current task's scope and pace unchanged.
  • Bare /sidenote flushes the open list back to you.
  • Apparent urgency doesn't override the park contract — a real emergency is a normal interruption, not a sidenote, so the command can't become a silent "drop everything" backdoor.

Changes

  • commands/sidenote.md — the command (auto-discovered as /sidenote, like /scalable).
  • bin/install.js — copies it on install, removes it on --uninstall (verified round-trip).
  • README.md — new section + intro line, including the plain-text SIDENOTE: prefix convention for agents without slash commands.

Verification

  • npm run check-sync green (single-source CLAUDE.md untouched).
  • Installer exercised end-to-end into a temp HOME: writes sidenote.md alongside scalable.md, uninstall removes it cleanly.

pallaoro added 2 commits July 17, 2026 08:55
… current task

A passing thought dropped mid-task reads as a new request, so the agent
rushes the big task to get to it. /sidenote reframes it as a parked
later-task: log it verbatim to .claude/sidenotes.md, one-line ack, resume
with scope and pace unchanged. Bare /sidenote flushes the list. Wired into
the installer (copy on install, remove on uninstall) and documented in
the README alongside /scalable, including the plain-text SIDENOTE: prefix
for agents without slash commands.
@pallaoro
pallaoro merged commit 6cc1c31 into main Jul 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant