aria-knowledge — Claude Code plugin: what it does, how to install
aria-knowledge builds a local Markdown memory base for Claude Code, preserving architecture choices and debugging context across sessions under human review.
no license ★ 19 updated 2026-10-22
/plugin marketplace add anthropics/claude-plugins-community
/plugin install aria-knowledge@claude-communityWhat aria-knowledge does
This plugin stops agents from starting from zero every time a session resets. When context compaction clears transcripts, key debugging insights and design agreements vanish. The tool stores this operational memory locally inside ~/Projects/knowledge/ as standard Markdown files.
Knowledge moves through defined capture and structuring steps. The /extract command scans conversations for fresh findings and removes duplicates. External files and URLs enter through /intake, while /distill and /codemap connect task tickets directly to repository paths. To carry the active state into the next run, use /handoff.
Captured items never become verified rules on their own. Every entry waits in a staging backlog first. You must deliberately review and promote records via /audit-knowledge before the assistant can treat them as trusted project facts.
What it helps with
- retain decisions and debugging discoveries across chat resets
- prevent reasoning continuity breaks caused by context compaction
- import external docs and links into a structured staging queue
- generate repository-grounded task specifications using
/distill - transfer full session context to future agent runs with
/handoff
Example prompts for the agent
- Run
/extractto harvest recent decisions and lessons from the dialogue - Use
/distillto create a grounded task spec citing actual repository files - Execute
/audit-knowledgeto inspect backlog entries and promote verified knowledge
How to install aria-knowledge
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install aria-knowledge@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about aria-knowledge
How to install aria-knowledge in Claude Code?
Run /plugin marketplace add anthropics/claude-plugins-community in Claude Code, then run /plugin install aria-knowledge@claude-community.
Where does the plugin store notes and decisions?
All knowledge lives locally in your ~/Projects/knowledge/ directory as standard Markdown documents.
Does the agent promote captured insights automatically?
No, raw findings land in a staging backlog. They only enter the trusted knowledge layer when you review and promote them inside /audit-knowledge.