From 99916933ec81296a92f37baa949028dd4118be66 Mon Sep 17 00:00:00 2001
From: Levi Neely <lneely@pascom.net>
Date: Fri, 20 Mar 2026 15:24:33 +0100
Subject: [PATCH] Update docs: beads now in separate 9beads repo

---
 BEADS.md  | 236 ------------------------------------------------------
 README.md |  41 +---------
 2 files changed, 2 insertions(+), 275 deletions(-)
 delete mode 100644 BEADS.md

diff --git a/BEADS.md b/BEADS.md
deleted file mode 100644
index ec6004a..0000000
--- a/BEADS.md
+++ /dev/null
@@ -1,236 +0,0 @@
-# Beads Integration
-
-9P filesystem integration for [steveyegge/beads](https://github.com/steveyegge/beads) task tracking.
-
-## Overview
-
-Beads provides persistent, structured task memory for coding agents. Tasks persist across crashes, enabling agents to resume work and coordinate through dependency graphs.
-
-**Storage:** Dolt (version-controlled SQL database) provides MVCC, ACID transactions, cell-level diffs, and JSONL export for git portability.
-
-## Filesystem Structure
-
-```
-anvillm/beads/
-├── ctl                    # Control file for commands
-├── query                  # Filtered query endpoint (write JSON filter, read results)
-├── list                   # All beads (JSON)
-├── ready                  # Ready beads (no blockers, JSON)
-├── pending                # Beads awaiting human approval/review (JSON)
-├── stats                  # Statistics (JSON)
-├── blocked                # Blocked issues (JSON)
-├── stale                  # Stale issues (not updated in 30+ days, JSON)
-├── config                 # All configuration (JSON)
-├── search/<query>         # Text search results (JSON)
-├── by-ref/<ref>           # Issue by external reference (JSON)
-├── batch/<id1,id2,...>    # Batch lookup by IDs (JSON)
-├── label/<label>          # Issues with label (JSON)
-├── children/<id>          # Direct children of parent (JSON)
-└── <bead-id>/
-    ├── status             # open | in_progress | closed
-    ├── title              # Bead title
-    ├── description        # Bead description
-    ├── assignee           # Assigned actor
-    ├── json               # Full bead with blockers (JSON)
-    ├── comments           # Issue comments (JSON)
-    ├── labels             # Issue labels (JSON)
-    ├── dependents         # Issues that depend on this (JSON)
-    ├── dependencies-meta  # Dependencies with metadata (JSON)
-    ├── dependents-meta    # Dependents with metadata (JSON)
-    ├── tree               # Dependency tree (JSON)
-    └── events             # Event history (JSON)
-```
-
-## Control Commands
-
-| Command | Format | Description |
-|---------|--------|-------------|
-| `new` | `new 'title' ['description'] [parent-id]` | Create new bead (optionally as child) |
-| `create` | `create 'title' ['description'] [parent-id]` | Alias for new |
-| `claim` | `claim <bead-id>` | Claim bead (sets assignee + in_progress) |
-| `complete` | `complete <bead-id>` | Mark bead as completed |
-| `close` | `close <bead-id>` | Alias for complete |
-| `fail` | `fail <bead-id> 'reason'` | Mark bead as failed |
-| `dep` | `dep <child-id> <parent-id>` | Add dependency (parent blocks child) |
-| `add-dep` | `add-dep <child-id> <parent-id>` | Alias for dep |
-| `undep` | `undep <child-id> <parent-id>` | Remove dependency |
-| `rm-dep` | `rm-dep <child-id> <parent-id>` | Alias for undep |
-| `update` | `update <bead-id> <field> 'value'` | Update bead field |
-| `delete` | `delete <bead-id>` | Delete bead |
-| `rm` | `rm <bead-id>` | Alias for delete |
-| `comment` | `comment <bead-id> 'text'` | Add comment to bead |
-| `label` | `label <bead-id> 'label'` | Add label to bead |
-| `unlabel` | `unlabel <bead-id> 'label'` | Remove label from bead |
-| `set-capability` | `set-capability <bead-id> low\|standard\|high` | Set capability level (replaces existing) |
-| `init` | `init [prefix]` | Initialize beads with custom ID prefix (default: bd) |
-| `batch-create` | `batch-create <json-array>` | Create multiple beads from JSON array |
-
-## Usage Examples
-
-```sh
-# Create bead
-echo "new 'Implement auth' 'Add OAuth support'" | 9p write anvillm/beads/ctl
-
-# Claim bead
-echo "claim bd-a1b2" | 9p write anvillm/beads/ctl
-
-# Complete bead
-echo "complete bd-a1b2" | 9p write anvillm/beads/ctl
-
-# List ready beads
-9p read anvillm/beads/ready
-
-# List blocked beads
-9p read anvillm/beads/blocked
-
-# List stale beads (not updated in 30+ days)
-9p read anvillm/beads/stale
-
-# Get statistics
-9p read anvillm/beads/stats
-
-# Get all configuration
-9p read anvillm/beads/config
-
-# Search for beads
-9p read anvillm/beads/search/authentication
-
-# Get bead by external reference
-9p read anvillm/beads/by-ref/JIRA-123
-
-# Batch lookup multiple beads
-9p read anvillm/beads/batch/bd-a1b2,bd-c3d4,bd-e5f6
-
-# Get beads with specific label
-9p read anvillm/beads/label/backend
-
-# Get children of a parent bead
-9p read anvillm/beads/children/bd-a1b2
-
-# Read bead status
-9p read anvillm/beads/bd-a1b2/status
-
-# Read full bead with blockers
-9p read anvillm/beads/bd-a1b2/json
-
-# Read bead comments
-9p read anvillm/beads/bd-a1b2/comments
-
-# Read bead labels
-9p read anvillm/beads/bd-a1b2/labels
-
-# Read bead dependents
-9p read anvillm/beads/bd-a1b2/dependents
-
-# Read dependencies with metadata
-9p read anvillm/beads/bd-a1b2/dependencies-meta
-
-# Read dependents with metadata
-9p read anvillm/beads/bd-a1b2/dependents-meta
-
-# Read dependency tree
-9p read anvillm/beads/bd-a1b2/tree
-
-# Read event history
-9p read anvillm/beads/bd-a1b2/events
-
-# Add dependency (parent blocks child)
-echo "dep bd-child bd-parent" | 9p write anvillm/beads/ctl
-
-# Update bead field
-echo "update bd-a1b2 priority 1" | 9p write anvillm/beads/ctl
-
-# Add comment
-echo "comment bd-a1b2 'Work in progress'" | 9p write anvillm/beads/ctl
-
-# Add label
-echo "label bd-a1b2 'backend'" | 9p write anvillm/beads/ctl
-
-# Set capability level
-echo "set-capability bd-a1b2 high" | 9p write anvillm/beads/ctl
-
-# Initialize with custom prefix
-echo "init myprefix" | 9p write anvillm/beads/ctl
-```
-
-## Filtered Queries
-
-The `anvillm/beads/query` endpoint accepts JSON filter criteria for complex queries.
-
-**Note:** The query endpoint is stateful per session. Write a filter to set the query, then read to retrieve results. The filter persists until overwritten.
-
-```sh
-# Query by assignee and priority
-echo '{"assignee":"alice","priority":1}' | 9p write anvillm/beads/query
-9p read anvillm/beads/query
-
-# Query by status and type
-echo '{"status":"open","issue_type":"bug"}' | 9p write anvillm/beads/query
-9p read anvillm/beads/query
-
-# Query by labels (all must match)
-echo '{"labels":["backend","urgent"]}' | 9p write anvillm/beads/query
-9p read anvillm/beads/query
-
-# Query by parent ID
-echo '{"parent_id":"bd-abc"}' | 9p write anvillm/beads/query
-9p read anvillm/beads/query
-```
-
-Available filter fields:
-- `assignee` (string): Filter by assignee
-- `status` (string): Filter by status (open, in_progress, closed, etc.)
-- `issue_type` (string): Filter by type (task, bug, feature, etc.)
-- `priority` (int): Filter by priority (1-5)
-- `labels` (array): Filter by labels (all must match)
-- `parent_id` (string): Filter by parent ID
-
-## Initialization
-
-Initialize beads in a project (creates `.beads/` directory with Dolt database):
-
-```go
-import "anvillm/internal/beads"
-
-err := beads.InitBeads("/path/to/project")
-```
-
-Agents access via 9P at `anvillm/beads/`:
-
-```sh
-cat anvillm/beads/ready
-echo 'claim bd-xyz' > anvillm/beads/ctl
-```
-
-## MCP Integration
-
-Beads are accessed via `execute_code` through 9P:
-
-```bash
-# Create a bead
-echo 'new "Implement login" "Add JWT auth"' | 9p write anvillm/beads/ctl
-
-# List beads
-9p read anvillm/beads/list | jq '.[] | "\(.id): \(.title)"'
-
-# Claim and complete
-echo 'claim bd-a1b2' | 9p write anvillm/beads/ctl
-echo 'complete bd-a1b2' | 9p write anvillm/beads/ctl
-```
-
-## Benefits
-
-- **Crash resilience** — Beads persist in Dolt database
-- **Resumability** — Agents pick up where others left off
-- **Dependency tracking** — Automatic blocking relationships
-- **Version control** — Full history via Dolt
-- **Git portability** — JSONL export syncs via git
-- **Scriptability** — Standard file operations
-- **Pure Go** — No Python dependency
-
-**Implementation:** `beads.go` (storage wrapper), `fs.go` (9P handlers) — ~300 LOC
-
-## See Also
-
-- [steveyegge/beads](https://github.com/steveyegge/beads)
-- [Dolt](https://github.com/dolthub/dolt)
diff --git a/README.md b/README.md
index 26b78b5..6b9f779 100644
--- a/README.md
+++ b/README.md
@@ -77,7 +77,7 @@ bash <(9p read tools/<scriptname>)
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `NAMESPACE` | `/tmp/ns.$USER.:0` | 9P namespace for server/client communication |
-| `ANVILLM_BEADS_PATH` | `~/.beads` | Beads database location (shared across namespaces) |
+| `ANVILLM_BEADS_PATH` | `~/.beads` | Beads database location (used by 9beads) |
 | `ANVILLM_TERMINAL` | `foot` | Terminal command for tmux attach (Assist) |
 | `ANTHROPIC_API_KEY` | — | Claude API key (optional if using `claude /login`) |
 | `CLAUDE_AGENT_NAME` | `anvillm-agent` | Claude agent configuration name |
@@ -192,32 +192,6 @@ anvillm/
 ├── ctl             # "new <backend> <cwd>" creates session
 ├── list            # id, alias, state, pid, cwd
 ├── events          # Event stream (state changes, messages)
-├── beads/          # Task tracking (persistent across namespaces)
-│   ├── ctl         # Commands: init, new, claim, unclaim, complete, fail,
-│   │               #   dep, undep, update, delete, comment, label, unlabel,
-│   │               #   set-capability, open, defer, reopen, mount, umount, sync
-│   ├── mtab        # Mounted projects
-│   ├── list        # All beads as JSON (optional limit arg)
-│   ├── ready       # Ready beads (no blockers) as JSON
-│   ├── deferred    # Deferred beads as JSON
-│   ├── blocked     # Blocked beads as JSON
-│   ├── stale       # Stale beads as JSON
-│   ├── search/     # search/<query> — full-text search
-│   ├── by-ref/     # by-ref/<ref> — lookup by external reference
-│   ├── batch/      # batch/<id1,id2,...> — fetch multiple beads
-│   ├── label/      # label/<name> — filter by label
-│   ├── children/   # children/<id> — subtasks of a bead
-│   └── <bead-id>/
-│       ├── status
-│       ├── title
-│       ├── description
-│       ├── assignee
-│       ├── json
-│       ├── comments
-│       ├── labels
-│       ├── dependents
-│       ├── tree
-│       └── events
 └── <id>/
     ├── ctl         # "stop", "restart", "kill"
     ├── state       # starting, idle, running, stopped, error, exited
@@ -243,18 +217,7 @@ Different clients interact with different parts of the filesystem: frontends rea
 
 ### Beads
 
-Persistent task tracking via [beads](https://github.com/steveyegge/beads) — Dependency-aware graph
-
-```sh
-echo 'init' | 9p write anvillm/beads/ctl
-echo 'new "Implement login" "Add JWT auth"' | 9p write anvillm/beads/ctl
-echo 'claim bd-a1b2' | 9p write anvillm/beads/ctl
-echo 'complete bd-a1b2' | 9p write anvillm/beads/ctl
-echo 'dep bd-child bd-parent' | 9p write anvillm/beads/ctl  # child blocks parent
-9p read anvillm/beads/ready | jq -r '.[] | "\(.id): \(.title)"'
-```
-
-Config: `~/.beads/` (override: `ANVILLM_BEADS_PATH`) — Shared across namespaces — See `internal/beads/README.md`
+Task tracking is provided by the separate [9beads](https://github.com/lneely/9beads) service, which exposes a `beads/` 9P filesystem.
 
 ### Events & Mailbox