How clickety-clacks/tightbeam works
Tightbeam is a standalone service that runs an organization of vendor-harness AI agents. The main workflow is an owner filing work, the organization executing and reviewing it, and owner-only decisions being returned for action; CLI commands also let operators and external agents interact with the gateway. The README documents durable records, deterministic rules, cross-vendor review, and recovery, but most Elixir runtime modules were not sampled. Those subsystems are represented at their exact tree paths; connections not established by the README or excerpts are omitted.
Main entry points: main.rs CLI entry · work_items.ex Ticket work · ceremonies.rs Setup ceremonies · dispatch.rs Gateway dispatch
Components 30
Gateway and access
- Gateway service
lib/tightbeam/gateway.ex - Wire router
lib/tightbeam/wire/router.ex - ACP adapters
lib/tightbeam/acp/adapter.ex
Organizational work
- Ticket work
lib/tightbeam/work_items.ex - Assignments
lib/tightbeam/assignments.ex - Cross-vendor review
lib/tightbeam/roles.ex - Owner decisions
lib/tightbeam/escalation.ex
Agent execution
- Vendor harnesses
lib/tightbeam/harness/claude.ex - Turn lifecycle
lib/tightbeam/turn_lifecycle.ex
Rules and record
- Durable record
lib/tightbeam/db.ex - Attributed history
lib/tightbeam/event_log.ex - Deterministic rules
lib/tightbeam/rules.ex
CLI operations
- CLI entry
cli/src/main.rs - Command parsing
cli/src/args.rs - Gateway dispatch
cli/src/dispatch.rs - Setup ceremonies
cli/src/ceremonies.rs - Harness catalog
cli/src/harnesses.rs - Host preflight
cli/src/preflight.rs - Environment probe
cli/src/probe.rs - Process containment
cli/src/contain.rs - Child processes
cli/src/child_process.rs - Anthropic OAuth
cli/src/anthropic_oauth.rs - Catalog probe
cli/src/catalog_probe.rs - Visitor identity
cli/src/visitor.rs - Request leases
cli/src/lease.rs - Base directory
cli/src/base_dir.rs - Onboarding output
cli/src/onboard_emit.rs - Harness process
cli/src/harness_process.rs
Other components
- Owner
- External agent
Connections 25
- Owner → Ticket work: files tickets
- Ticket work → Assignments: organizes work
- Assignments → Vendor harnesses: assigns agents
- Vendor harnesses → Turn lifecycle: runs turns
- Turn lifecycle → Cross-vendor review: supports review
- Cross-vendor review → Owner decisions: triages decisions
- Owner decisions → Owner: requests decision
- Ticket work → Durable record: records work
- Durable record → Attributed history: preserves history
- Deterministic rules → Ticket work: governs work
- External agent → CLI entry: invokes CLI
- CLI entry → Process containment: routes rail-exec
cli/src/main.rs - CLI entry → Harness process: routes harness-exec
cli/src/main.rs - CLI entry → Catalog probe: routes catalog-probe
cli/src/main.rs - Gateway dispatch → Gateway service: calls gateway
cli/src/dispatch.rs - Harness catalog → Gateway dispatch: loads catalog via
cli/src/harnesses.rs - Host preflight → Harness catalog: uses catalog
cli/src/preflight.rs - Setup ceremonies → Anthropic OAuth: uses OAuth
cli/src/ceremonies.rs - Setup ceremonies → Request leases: bounds calls
cli/src/ceremonies.rs - CLI entry → Command parsing: parses commands
cli/src/main.rs - CLI entry → Gateway dispatch: dispatches commands
cli/src/main.rs - Environment probe → Harness catalog: inspects harnesses
cli/src/probe.rs - CLI entry → Base directory: resolves location
cli/src/main.rs - Setup ceremonies → Onboarding output: emits onboarding
cli/src/ceremonies.rs - CLI entry → Visitor identity: handles identity
cli/src/main.rs