Metadata-Version: 2.4
Name: continuity-note
Version: 0.1.0
Summary: Install the continuity-note agent skill: write a self-contained handoff so a fresh context can resume work.
Project-URL: Homepage, https://github.com/mauriziomocci/continuity-note
Project-URL: Repository, https://github.com/mauriziomocci/continuity-note
Project-URL: Changelog, https://github.com/mauriziomocci/continuity-note/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/mauriziomocci/continuity-note/issues
Author-email: Maurizio Mocci <mauriziomocci64@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,claude,claude-code,codex,continuity,handoff,llm,skill
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# continuity-note

*Read this in [Italiano](README.it.md).*

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

```bash
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:

```bash
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

```bash
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

| Target   | Agent(s)                  | Skills directory        |
|----------|---------------------------|-------------------------|
| `claude` | Claude Code               | `~/.claude/skills`      |
| `codex`  | Codex                     | `$CODEX_HOME/skills` (default `~/.codex/skills`) |
| `agents` | Copilot CLI, Gemini CLI   | `~/.agents/skills`      |

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](LICENSE).
