continuity-note

Read this in Italiano.

Install the continuity-note agent skill into your AI coding tools.

A continuity note is a self-contained handoff document: it lets a fresh context — another agent, a teammate, or you tomorrow — resume in-progress work without replaying the conversation. The skill teaches your agent to write one well: a fixed structure (goal, current state, next steps, key decisions, gotchas, files, how to verify, open questions), references to artifacts instead of pasted copies, redacted secrets, and an honest split between what was verified and what was only assumed.

This package is a small installer. The skill itself is plain Markdown; the CLI copies it into the skills directory your agent already reads.

Install

pip install continuity-note      # or: pipx install continuity-note
continuity-note install          # copies the skill into detected agents

install with no arguments auto-detects which agents are present and installs into each. Choose explicitly with target names:

continuity-note install claude          # Claude Code  (~/.claude/skills)
continuity-note install codex           # Codex        ($CODEX_HOME/skills)
continuity-note install agents          # Copilot CLI / Gemini CLI (~/.agents/skills)
continuity-note install all             # all of the above
continuity-note install --target ~/my/skills   # a custom directory

The skill is copied as a physical file (not a symlink), so it keeps working after you pip uninstall continuity-note or switch virtualenvs.

Use

Once installed, restart your agent so it picks up the new skill, then just ask:

write a continuity note for what we did today

or "hand this off", "save state, context is running out", "document where we are so I can continue tomorrow". The agent writes the note to your working directory as continuity-note-<topic>-<date>.md and tells you the path.

Manage

continuity-note status           # show where it's installed and whether current
continuity-note install --force  # update after upgrading the package
continuity-note uninstall        # remove from all known agents

Supported agents

Any other agent that reads a skills directory of SKILL.md files works too — point --target at it.

License

MIT. The skill is derived from the original "handoff" skill by Matt Pocock (also MIT); see LICENSE.