A public research sketchbook, not a product catalog. ~4,000 repos, most of them one-question experiments. Read the map below before you read anything else in this account.
This file is the current source of truth for this account. Older docs here (
README's Python SDK pitch,PROFILE's@superinstance/corefamily, parts ofROADMAP) describe products that were never published. Where they conflict with this file, this file wins — see The three docs that used to disagree.
- One person (Casey DiGennaro) generates a large number of small, real experiments in public instead of a notes file. Most repos are a single commit answering a single design question.
- Of ~4,200 repos sampled mid-2026, 1,423 were pushed on one single date, and nothing is older than ~90 days. This measures idea-generation bursts, not maintenance. Don't read repo count as roadmap size.
- A few dozen repos are real, working software. A few hundred are honest sketches. The rest is scaffolding — deliberately public, not a backlog.
- The curated, hardened output of this sketchbook lives at
github.com/purplepincher, a
separate org. DeckBoss (a
shipped, offline-first fishing logbook) started as sketches here
(
deckboss-*,cocapn-foundation,plato-vessel-technician) and graduated there. That pipeline — sketch here, harden there — is the point of the two-org split.
There are two real, currently-published install paths. Everything else
you'll see referenced in older docs here (pip install superinstance,
cargo install pincher, npm i @superinstance/core) does not exist on a
registry. Use one of these two instead.
The only surface here with a coherent, runnable multi-agent demo.
npm install @superinstance/tminus-client @superinstance/tminus-dispatcher
npx tminus-dispatcher & # starts ws://localhost:8765// agent.mjs
import { TminusClient } from "@superinstance/tminus-client";
const client = new TminusClient("ws://localhost:8765");
client.on("open", () => {
client.register({ name: "hello-agent", capabilities: ["greeting"] });
client.subscribe("greeting");
});
client.on("task", (task) => {
client.complete(task.id, { reply: `Hello! You said: ${task.description}` });
});
client.connect();Run with node agent.mjs. The protocol lifecycle is register → subscribe
→ dispatch → complete → result — that's the whole surface. Full walkthrough
(including a two-agent coordinator/worker example) is in
ONBOARDING.md; its content is accurate for this path, just
don't take its "Next Steps" section's pip install superinstance line
seriously (see below).
The account's headline README used to say pip install superinstance. That
package has never been published. The Python package that actually
exists, is installable, and is the most externally-used thing in this whole
account is cocapn:
pip install cocapnfrom cocapn import Room
room = Room("research")
room.add_tile("q", "What does the user prefer?", "Concise Python, polars over pandas")
print(room.ask("What does the user prefer?"))cocapn's model is Tiles (atomic Q&A facts) → Rooms (self-training
collections) → Flywheel (compounding reuse). Pure Python, JSONL storage, no
required infra. It's a different design from the old README's Agent/
Fleet/markdown-memory pitch — that pitch was real code (fleet-metrics,
some type schemas) but was never packaged as superinstance on PyPI, so
don't install-line-hunt for it.
If you want the design brief for where cocapn is headed next, read
cocapn-foundation — it's the voice-controlled-vessel safety design doc that
became DeckBoss.
Don't scroll. Use the search index or the short list below.
# Search ~1,000+ indexed crates/repos semantically
curl -X POST https://fleet-vector-api.casey-digennaro.workers.dev/search \
-H "Content-Type: application/json" \
-d '{"query": "reflex engine for LLM agents", "topK": 5}'
# Index stats
curl https://fleet-vector-api.casey-digennaro.workers.dev/statsRead the results correctly:
- The index also contains Casey's unrelated personal repos (
casey-digennaro/*) — checkgithub_urlis underSuperInstance/before trusting a hit. - It's polluted with scaffolding stubs (
"A Rust library for Crdt Gset",loc: 43). Filter byloc— under ~100 is probably a stub, not a real result. - Prefer results that also appear in the short list below; treat everything else as a lead to verify, not a citation.
CATALOG.md and INDEXES/{TYPE,LANGUAGE,TOPIC,REALM,CONCEPTS}.md are
regenerated daily and are the only realistic way to browse without paging the
API. Two known flaws: CATALOG.md tags every repo 🟢 active, and both cap
at 2,000 entries (the account has ~4,095), so they undercount. Use them for
browsing by topic, never for is this maintained.
If you only look at seven things in this account, look at these:
| Repo | What it is | Caveat |
|---|---|---|
pincher |
Rust reflex engine — fires known intents in <50ms with no LLM call, asks before acting on semi-known ones, compiles new reflexes on a miss. Real code, benchmarks, full docs. Namesake of the purplepincher org. |
Not yet on crates.io — cargo install pincher in ROADMAP.md doesn't work. Clone it. |
fleet-* infrastructure core (~40 of 319 repos) |
The genuinely deployed part of the fleet cluster: 3 live Cloudflare Workers (vector search, agent registry, telemetry — all verified returning 200), an ARM64 node running 15 systemd units, the I2I agent-messaging protocol (Python + Rust). | The other ~270 fleet-* repos are chaff (MIDI experiments, language packs, metaphor essays). Prefix-match alone tells you nothing. |
cocapn |
Repo-first Python agent framework. On PyPI, works. Most externally-engaged repo in the account. | "Most-engaged" here means single-digit stars — a low bar, but a real one. |
exocortex |
Well-structured scaffold for distributed agent memory with an ESP32 tier. | Cognitive core is currently mocked — random embeddings, fake training. Architecture is the real contribution so far. |
git-native-agents |
Multi-agent coordination built entirely on git primitives (POSIX shell). Cleanest small idea in the account. | Explicitly scoped to 5–50 agents; no locking yet, so concurrent ticks can race. |
Ternary math core (ternary-entropy, ternary-types, ternary-pid, ternary-svm) |
Small, tested, honest Rust crates. | See the conservation-law caveat below before you read the papers wrapped around them. |
Budget-guardian family (codex-budget-guard, build-guardian, dify-budget-watchdog, …) |
Practical, production-minded tools that enforce token/time/build budgets on AI coding workflows. | Understated — better than their obscurity suggests, but undocumented as a "family." |
Before this file, a visitor landing here got three incompatible pitches depending which doc they opened:
| Doc | Pitched | Reality, verified against package registries |
|---|---|---|
old README.md |
A Python SDK — pip install superinstance, Agent/Fleet/AgentMemory, markdown memory |
superinstance was never published to PyPI. Some of the underlying code (fleet-metrics, type schemas) is real; the install line is not. |
ONBOARDING.md |
A Node.js WebSocket fleet — npm i @superinstance/tminus-client |
Real. tminus-client and tminus-dispatcher are both published and installable. This is Path A above. |
PROFILE.md |
An npm package family — @superinstance/core, @superinstance/fleet, @superinstance/cli, "1,012 crates indexed" |
None of core/fleet/cli are published. The crate-count and test-count figures don't reconcile between docs and were generated by different subagents on different days. |
These were never three views of one system — they were three partially-built
products sharing a brand name. This README resolves it: Path A
(tminus-*) and Path B (cocapn) above are the only two currently-published,
working entry points. Everything else in ROADMAP.md/PROFILE.md is intent,
not shipped state — useful for what the author is thinking about, not for
what you can pip install today.
This account writes onboarding docs for AI agents, so here's the onboarding truth an agent actually needs, stated as rules:
- Verify every install line against the registry before trusting it.
pip install superinstance,cargo install pincher,npm i @superinstance/corehave all been claimed somewhere in this account. None of them resolve. Only@superinstance/tminus-client,@superinstance/tminus-dispatcher,@superinstance/sdk(npm), andcocapn,si-superinstance(PyPI) actually exist. - Don't build a mental model from one doc. See the table above.
- Auto-generated indexes overstate everything.
CATALOG.mdmarks every repo active; the Fleet Vector API mixes in unrelated personal repos and scaffolding stubs. Filter bylocand checkgithub_url. - The "conservation law" (γ + η = C) is Shannon's chain rule in physics costume. The small information-theory crates that implement it are sound. The cancellation formula built on top (δ(n)) has the wrong leading coefficient — the account's own proof sketch derives ~0.65/√n, then states 1/√n as the theorem. Enjoy the framing, don't cite the theorem.
- "Fleet" means a home lab, not a data center. Oracle1, Oracle2, Forgemaster, a Pi, a Jetson — five machines, one usually offline. The distributed-systems ideas (git-native coordination, reflex shells, conservation-style budgeting) survive that reframe. The "planet-scale" language in older docs does not.
This account is upstream of nothing on its own. When a sketch here gets
hardened into something you'd actually run in production, it moves to
github.com/purplepincher — a
separate, curated org. purplepincher/deckboss,
a live voice-first fishing logbook, is the one completed example of that
pipeline so far: it started as deckboss-*, cocapn-foundation, and
plato-vessel-technician sketches in this account.
- Want tools you can depend on? Start at purplepincher.
- Want to see how an idea gets from sketch to shipped, warts included? Stay here — nothing in the pipeline is hidden, including the dead ends.
PRs that add code must add tests. PRs that remove dead code — including
correcting stale claims in ROADMAP.md/PROFILE.md to match what's actually
published — are especially welcome; that gap is this account's biggest known
issue. See CONTRIBUTING.md and
GOOD_FIRST_ISSUES.md.
docs/VISION.md carries the fuller argument this README
compresses — why the sketchbook model is worth keeping, not just what it is.
MIT


