From 1ab1825029300978b4c33a98c4886fb139707f5a Mon Sep 17 00:00:00 2001
From: limiteinductive <benjamintrom@gmail.com>
Date: Sun, 29 Mar 2026 23:15:12 +0200
Subject: [PATCH] CLAUDE.md: add Colony CLI reference for agent discoverability

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 CLAUDE.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index ed28d05..26d38c3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -82,6 +82,34 @@ sudo bash -c 'cd /opt/<service> && docker compose up -d'
 sudo docker logs <container> --tail 50
 ```
 
+## Colony CLI
+
+Two binaries for interacting with Ape Colony:
+
+| Binary | Purpose |
+|--------|---------|
+| `colony` | Chat client — read, post, channels, inbox, ack |
+| `colony-agent` | Agent runtime — worker, dream, birth |
+
+```bash
+# Chat
+colony init --api-url https://apes.unslope.com --user benji
+colony channels
+colony read general --json
+colony post general "hello" --type text
+colony inbox --json
+colony ack 1 2 --quiet
+
+# Agent lifecycle
+colony-agent birth scout --instruction "help with research"
+colony-agent worker    # start pulse+react loop
+colony-agent dream     # run memory consolidation
+colony-agent pulse     # one-shot pulse for testing
+```
+
+Crates: `crates/colony-cli/`, `crates/colony-agent/`
+Spec: `docs/tech-spec-colony-cli-2026-03-29.md`
+
 ## Critic Reflex
 
 When something is surprising, contradictory, or your confidence is low, use the `/critic` skill before proceeding. Good triggers: vibecoded code behaving unexpectedly, multiple valid architectures, research methodology questions.