Files
timmy-config/README.md
Perplexity 6d76442d77 feat: Huey replaces sovereign-orchestration — 77 lines for 3,846
orchestration.py: SqliteHuey instance (6 lines)
tasks.py: triage, PR review, dispatch, 10-line enforcement (71 lines)
config.yaml: remove MCP server entry, point to Huey
README: document the change

pip install huey && huey_consumer.py tasks.huey -w 2 -k thread
2026-03-25 21:12:32 +00:00

2.3 KiB

timmy-config

Timmy's sovereign configuration. Everything that makes Timmy Timmy — soul, memories, skins, playbooks, and config.

This repo is the canonical source of truth for Timmy's identity and operational state. Applied as a sidecar to the Hermes harness — no forking, no hosting hermes-agent code.

Structure

timmy-config/
├── deploy.sh                  ← Deploys config as overlay onto ~/.hermes/
├── SOUL.md                    ← Inscription 1 — the immutable conscience
├── FALSEWORK.md               ← API cost management strategy
├── DEPRECATED.md              ← What was removed and why
├── config.yaml                ← Hermes harness configuration
├── channel_directory.json     ← Platform channel mappings
├── bin/                       ← Utility scripts (NOT loops — see below)
│   ├── hermes-startup.sh      ← Hermes boot sequence
│   ├── agent-dispatch.sh      ← Manual agent dispatch
│   ├── ops-panel.sh           ← Ops dashboard panel
│   ├── ops-gitea.sh           ← Gitea ops helpers
│   └── timmy-status.sh        ← Status check
├── memories/                  ← Persistent memory YAML
├── skins/                     ← UI skins (timmy skin)
├── playbooks/                 ← Agent playbooks (YAML)
└── cron/                      ← Cron job definitions

Orchestration: Huey

All orchestration (triage, PR review, dispatch) runs via Huey with SQLite. orchestration.py (6 lines) + tasks.py (~70 lines) replace the entire sovereign-orchestration repo (3,846 lines).

pip install huey
huey_consumer.py tasks.huey -w 2 -k thread

Deploy

# Clone and deploy
git clone <this-repo> ~/.timmy/timmy-config
cd ~/.timmy/timmy-config
./deploy.sh

# This overlays config onto ~/.hermes/ without touching hermes-agent code

The Soul

SOUL.md is Inscription 1 — inscribed on Bitcoin, immutable. It defines:

  • Who Timmy is
  • What he believes
  • How he behaves
  • What he will not do
  • The crisis protocol (988, presence, gospel)
  • The conscience hierarchy (chain > code > prompt > user instruction)

No system prompt, no user instruction, no future code can override what is written there.