# 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](https://github.com/zk-org/zk) CLI tool:

```bash
# macOS
brew install zk

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

## Installation

```bash
/plugin install zk@pair-programmer
```

## Setup

### Project Notebook (recommended)

Create a notebook in your project:

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

### Global Notebook (optional)

For cross-project knowledge:

```bash
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:

```bash
/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:

```bash
/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.