codeplow

# codeplow

**Plugins for AI coding agents that fight context rot, doc rot, and forgotten decisions.** Native on **Claude Code**, **GitHub Copilot CLI**, **Cursor**, and **Codex CLI**.

Built by [Wael Masri](https://waelmas.com).

---

## What's in the marketplace

Today, one plugin. More coming — they'll land as siblings in this repo.

### [`obsidian-kb`](obsidian-kb/) — persistent, per-project memory for your AI coding agent

A real [Obsidian](https://obsidian.md) vault per project, sitting inside the project folder by default (committable), holding structured knowledge your agent can read between sessions.

| Capability | Command | What happens |
|---|---|---|
| Build a **project knowledge base** from your codebase | `/kb-init` | Parallel subagents write Architecture / Tech Stack / Patterns / etc. notes into the vault. 3–6 minutes. |
| **Keep the KB aligned** with recent changes | `/kb-update` | Reviews git activity + session context, surgically refreshes stale KB notes with `file:line` evidence, flags new concepts as candidates. |
| **Audit your project docs** for drift | `/kb-init` or `/kb-audit` | Flags every stale claim in the project's own markdown (README.md, ARCHITECTURE.md, etc.) with `file:line` evidence. |
| **Session handoff** — beat context rot | `/kb-offboard` *(alias `/kb-handoff`)* | Writes an adaptive handoff into the vault (TL;DR, decisions, files changed, gotchas, next steps), linked from the index and wiki-linked to related KB notes. |
| **Session onboarding** — pick up in a new session | `/kb-onboard` | New agent reads the latest handoff and the linked KB notes before starting work. |
| **Visual knowledge map** | `/kb-graph` | Opens the vault in Obsidian's graph view. |
| Empty scaffold (hand-populated KB) | `/kb-scaffold` | Vault structure only, no codebase analysis. |

The vault is plain markdown on disk — committable alongside your code, editable by hand, grep-able, zero lock-in. Not a vector DB, not a CLAUDE.md replacement.

---

## Prereq