accidental.cc
personal claude plugins marketplace
1# ZK Plugin
2
3A zettelkasten memory system for Claude Code that maintains conversation continuity through persistent notes.
4
5## What It Does
6
7- **Zero conversational loss** - captures insights, decisions, dead-ends automatically
8- **Session context** - loads relevant notes at session start
9- **Background gardening** - maintains notebook health without blocking your work
10- **Dual notebook support** - project-specific and global knowledge bases
11
12## Prerequisites
13
14Requires the [zk](https://github.com/zk-org/zk) CLI tool:
15
16```bash
17# macOS
18brew install zk
19
20# Linux (from source)
21go install github.com/zk-org/zk@latest
22```
23
24## Installation
25
26```bash
27/plugin install zk@pair-programmer
28```
29
30## Setup
31
32### Project Notebook (recommended)
33
34Create a notebook in your project:
35
36```bash
37mkdir -p .claude/zk
38cd .claude/zk
39zk init
40```
41
42### Global Notebook (optional)
43
44For cross-project knowledge:
45
46```bash
47mkdir -p ~/.claude/zk
48cd ~/.claude/zk
49zk init
50```
51
52## Usage
53
54### Automatic (via hook)
55
56The plugin detects notebooks on session start and reminds Claude of its stewardship responsibilities.
57
58### Manual
59
60Invoke the skill explicitly:
61
62```bash
63/zk
64```
65
66Then have a conversation. Claude will:
67- Search for relevant prior notes
68- Capture new insights as you discuss
69- Spawn background gardening when needed
70
71### Gardening
72
73For explicit maintenance:
74
75```bash
76/zk-gardener # Quick mode
77/zk-gardener deep # Comprehensive analysis
78```
79
80## Skills Included
81
82### zk (Mirror)
83
84The conversational partner that:
85- Loads context from your notebook
86- Captures insights proactively
87- Links new notes to existing knowledge
88- Spawns background gardening
89
90### zk-gardener
91
92The maintenance agent that:
93- Validates note structure and links
94- Spot-checks random notes
95- Updates the index
96- Suggests consolidations
97
98## Notebook Structure
99
100```
101.claude/zk/
102├── .zk/
103│ └── config.toml # zk configuration
104├── _index.md # Auto-generated index
105├── notes/ # Your notes
106├── .last-gardened # Timestamp (managed)
107└── .last-garden-report.md # Latest gardening report
108```
109
110## Pairing with Coworker Style
111
112This plugin works great with the `coworker-output-style` plugin from the same marketplace. The conversational style makes the capture feel natural rather than mechanical.