Save, search, and organize persistent markdown notes with automatic expiry via a CLI.
npx skills add https://github.com/yamadashy/repomix --skill agent-carnet
Please help me install this Agent Skill. Skill: agent-carnet Source: https://github.com/yamadashy/repomix/tree/main/.agents/skills/agent-carnet Command: npx skills add https://github.com/yamadashy/repomix --skill agent-carnet
AI agents and developers lose hard-won findings between sessions — debugging dead-ends get re-explored, naming conventions drift, and research results vanish. This Skill provides a shared on-disk markdown notebook with automatic staleness management so useful knowledge survives and stale notes clean themselves up.
.carnet/<category>/<slug>.md with required summaries, then search summaries with find, browse with list, and read full content with show.used increments a durable importance counter, while auto-pruned notes rest in .trash/ for 7 days.vocab (canonical terminology) and hypothesis (debugging dead-ends) use the meta: frontmatter namespace for machine-readable data.hypothesis carnet with the verdict; the next agent finds it via agent-carnet find and skips the dead-end entirely.Ask the agent to save a note about the current finding using agent-carnet with a decisive summary and the claude-code agent flag.
High-intent search queries and answers about installing and using this skill.
Pipe the note body into agent-carnet save with a category/slug path, a required --summary flag, and --agent claude-code. Optionally add comma-separated --tags. Example: echo "body" | agent-carnet save deps/iconv-issue --summary "..." --agent claude-code.
Use agent-carnet find <term> to search summaries without affecting lifespan, agent-carnet list for a category-grouped overview, and agent-carnet show <path> to read full content. Reading with show resets the note's last_used date.
Each note expires 30 days after its last_used date, which is bumped by save, show, and used. Auto-prune runs on every CLI invocation and moves expired notes to .carnet/.trash/ for 7 days before hard deletion. Set keep: true or a custom lifespan to override.
show reads the note body and bumps last_used, a weak signal that only keeps the note alive. used additionally increments use_count, a strong importance signal recorded when a note actually shaped your work, and enables sorting by use_count.
Yes, use the meta: namespace for structured extension data like meta.vocab or meta.hypothesis. The CLI preserves all unknown frontmatter fields on round-trip writes, so custom keys survive save --update operations.
norrietaylorCapture session decisions and actions as tagged knowledge entries in Distillery.
masseaterRead past progress files to resume work across sessions.
chronista-clubAlign SPEC.md and DESIGN.md with the current codebase.
dropsyoonMaintain a persistent markdown wiki with keyword, tag, and category queries.