timmy-home/docs/QUICK_REFERENCE.md

Timmy Workflow Quick Reference

Updated: April 4, 2026

What Lives Where

• ~/.timmy: Timmy's workspace, lived data, heartbeat, archive artifacts
• ~/.timmy/timmy-config: Timmy's identity and orchestration sidecar repo
• ~/.hermes: Hermes harness, sessions, config overlay, helper scripts

Most Useful Commands

Workflow Status

~/.hermes/bin/ops-panel.sh
~/.hermes/bin/ops-gitea.sh
~/.hermes/bin/timmy-dashboard

Workflow Helpers

source ~/.hermes/bin/ops-helpers.sh
ops-help
ops-review-queue
ops-unassigned all
ops-queue codex-agent all

Pipeline Freshness

~/.hermes/bin/pipeline-freshness.sh

Archive Pipeline

python3 - <<'PY'
import json
import sys
from pathlib import Path

sys.path.insert(0, str(Path.home() / '.timmy' / 'timmy-config'))
from tasks import _archive_pipeline_health_impl
print(json.dumps(_archive_pipeline_health_impl(), indent=2))
PY

python3 - <<'PY'
import json
import sys
from pathlib import Path

sys.path.insert(0, str(Path.home() / '.timmy' / 'timmy-config'))
from tasks import _know_thy_father_impl
print(json.dumps(_know_thy_father_impl(), indent=2))
PY

Manual Dispatch Prompt

~/.hermes/bin/agent-dispatch.sh groq 542 Timmy_Foundation/the-nexus

Best Files to Check

Operational State

• ~/.timmy/heartbeat/last_tick.json
• ~/.hermes/model_health.json
• ~/.timmy/twitter-archive/checkpoint.json
• ~/.timmy/twitter-archive/metrics/progress.json

Archive Feedback

• ~/.timmy/twitter-archive/notes/
• ~/.timmy/twitter-archive/knowledge/profile.json
• ~/.timmy/twitter-archive/training/dpo/

Review and Queue

• Gitea PR queue
• Gitea unassigned issues
• Timmy/Allegro assigned review queue

Rules of Thumb

• If it changes identity or orchestration, review it carefully in timmy-config.
• If it changes lived outputs or training inputs, it probably belongs in timmy-home.
• If it only “sounds right” but is not proven by runtime state, it is not verified.
• If a change is major, package it as a PR for Timmy review.