obsidian-kb

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.

---

What's in the marketplace

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

obsidian-kb — persistent, per-project memory for your AI coding agent

A real Obsidian 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.

---

Prerequisites

obsidian-kb needs two things:

1. Obsidian desktop app (v1.12+) — brew install --cask obsidian / winget install Obsidian.Obsidian / download from obsidian.md.
2. Obsidian's CLI enabled. The CLI ships with the app but is OFF by default. Open Obsidian → Settings → General → scroll to the bottom → toggle "Command Line Interface" ON, then close and reopen your terminal so obsidian lands on PATH.

Both are required. The plugin preflight tells you which is missing and walks you through enabling the CLI, but knowing upfront saves a round-trip.

---

Install

Installation has two steps that live in two different places. Keep them straight or you'll paste the wrong command into the wrong place — which is the most common source of confusion.

1. Install the plugin — runs in your regular terminal (bash / zsh / PowerShell). 2. Use the plugin — runs inside your AI agent's chat or session, not in your terminal. Commands like /kb-init are typed to the agent. They start with / because they're slash commands the agent recognizes; your shell doesn't.

---

1. Install — in your terminal

Easiest — ask your agent to do it for you (from its own chat):

Install codeplow for me by following https://raw.githubusercontent.com/waelmas/codeplow/main/INSTALL.md

Or paste the one-liner into your terminal. It detects which AI tools you have installed and registers codeplow for each:

# macOS / Linux / WSL — paste into your terminal
curl -fsSL https://raw.githubusercontent.com/waelmas/codeplow/main/scripts/install.sh | bash

# Windows PowerShell — paste into a PowerShell window
iwr -useb https://raw.githubusercontent.com/waelmas/codeplow/main/scripts/install.ps1 | iex

Or install manually per platform — also terminal

All four snippets run in your regular terminal. They register codeplow with each tool's plugin system — they don't start the agent.

Claude Code

claude plugin marketplace add waelmas/codeplow
claude plugin install obsidian-kb@codeplow

GitHub Copilot CLI — reuses Claude Code's plugin format, so the same manifests serve both. Just a different binary:

copilot plugin marketplace add waelmas/codeplow
copilot plugin install obsidian-kb@codeplow

Cursor

git clone https://github.com/waelmas/codeplow ~/codeplow
mkdir -p ~/.cursor/plugins/local
ln -s ~/codeplow/obsidian-kb ~/.cursor/plugins/local/obsidian-kb
# Then in Cursor: Command Palette → Developer: Reload Window

Codex CLI

git clone https://github.com/waelmas/codeplow ~/codeplow
mkdir -p ~/.agents/plugins
cp ~/codeplow/.agents/plugins/marketplace.json ~/.agents/plugins/marketplace.json
# Then start Codex and open /plugins from inside its session

Once any of those finish, reload the agent so it picks up the plugin: