accidental.cc / claude-plugins
personal claude plugins marketplace
fork atom
claude-plugins / plugins / zk /
at main 4 folders 1 file
.claude-plugin
hooks
hooks-handlers
skills
README.md
README.md

ZK Plugin#

A zettelkasten memory system for Claude Code that maintains conversation continuity through persistent notes.

What It Does#

  • Zero conversational loss - captures insights, decisions, dead-ends automatically
  • Session context - loads relevant notes at session start
  • Background gardening - maintains notebook health without blocking your work
  • Dual notebook support - project-specific and global knowledge bases

Prerequisites#

Requires the zk CLI tool:

# macOS
brew install zk

# Linux (from source)
go install github.com/zk-org/zk@latest

Installation#

/plugin install zk@pair-programmer

Setup#

Create a notebook in your project:

mkdir -p .claude/zk
cd .claude/zk
zk init

Global Notebook (optional)#

For cross-project knowledge:

mkdir -p ~/.claude/zk
cd ~/.claude/zk
zk init

Usage#

Automatic (via hook)#

The plugin detects notebooks on session start and reminds Claude of its stewardship responsibilities.

Manual#

Invoke the skill explicitly:

/zk

Then have a conversation. Claude will:

  • Search for relevant prior notes
  • Capture new insights as you discuss
  • Spawn background gardening when needed

Gardening#

For explicit maintenance:

/zk-gardener        # Quick mode
/zk-gardener deep   # Comprehensive analysis

Skills Included#

zk (Mirror)#

The conversational partner that:

  • Loads context from your notebook
  • Captures insights proactively
  • Links new notes to existing knowledge
  • Spawns background gardening

zk-gardener#

The maintenance agent that:

  • Validates note structure and links
  • Spot-checks random notes
  • Updates the index
  • Suggests consolidations

Notebook Structure#

.claude/zk/
├── .zk/
│   └── config.toml        # zk configuration
├── _index.md              # Auto-generated index
├── notes/                 # Your notes
├── .last-gardened         # Timestamp (managed)
└── .last-garden-report.md # Latest gardening report

Pairing with Coworker Style#

This plugin works great with the coworker-output-style plugin from the same marketplace. The conversational style makes the capture feel natural rather than mechanical.