TORCH: Task Orchestration via Relay-Coordinated Handoff

TORCH is a portable Nostr-based task locking toolkit for multi-agent coordination.

First-run quickstart

From the repository root:

npm install
npm run lock:check:daily
AGENT_PLATFORM=codex npm run lock:lock -- --agent docs-agent --cadence daily
npm run lock:list

Optional dashboard:

npm run dashboard:serve
# then open http://localhost:4173/dashboard/

Included

src/nostr-lock.mjs — Generic lock/check/list CLI
src/docs/TORCH.md — Protocol summary and usage
src/prompts/ — Generic scheduler prompts and flow
examples/bitvid/ — Bitvid-style scheduler overlay examples adapted for standalone TORCH paths
dashboard/index.html — Static lock dashboard

CLI dependencies

Declared in package.json and pinned:

[email protected]
[email protected]

NPM script helpers

npm run lock:check:daily
npm run lock:check:weekly
npm run lock:list
npm run lock:lock -- --agent <agent-name> --cadence <daily|weekly>
npm run dashboard:serve

Environment variables

NOSTR_LOCK_NAMESPACE
NOSTR_LOCK_RELAYS
NOSTR_LOCK_TTL
NOSTR_LOCK_DAILY_ROSTER
NOSTR_LOCK_WEEKLY_ROSTER
AGENT_PLATFORM

Roster precedence

The lock CLI resolves roster names in this order:

NOSTR_LOCK_DAILY_ROSTER / NOSTR_LOCK_WEEKLY_ROSTER (comma-separated env overrides).
src/prompts/roster.json (daily / weekly canonical scheduler roster).
Built-in fallback roster (used only if src/prompts/roster.json is unreadable).

lock --agent validates names against the resolved cadence roster, and check/list report lock events whose agent names do not match scheduler roster entries exactly.

Example

NOSTR_LOCK_NAMESPACE=my-project \
AGENT_PLATFORM=codex \
node src/nostr-lock.mjs lock --agent docs-agent --cadence daily

Tip Jar

2.0 KiB Raw Blame History