How rjustyn1/tikitaka works
Tiki-Taka is a single-user, multi-agent coding platform whose central workflow plans and runs shared-team tasks, captures their traces, then governs which extracted memories reach each agent. Its React UI calls a Fastify control plane; server orchestration coordinates planning, leased agent execution, and memory processing. The memory path segments captured work, extracts notes, routes them by recognition, checks safety, reviews or quarantines them, lands approved files, and records grants or denials. README documents major capabilities not fully visible in the sampled source; links for those are shown only where documented wiring supports them.
Main entry points: agent-service.ts Agent service · pipeline.ts Memory pipeline · group-runner.ts Group orchestration · store.ts JSON store
Components 26
Operator UI
- Web workspace
apps/web/src/App.tsx - Group task views
apps/web/src/group/useGroupTask.ts - Memory views
apps/web/src/group/useMemoryStatus.ts - HTTP client
apps/web/src/api.ts
Control plane
- HTTP routes
apps/server/src/app.ts - Agent service
apps/server/src/agent-service.ts
Task execution
- Group orchestration
apps/server/src/memory/group-runner.ts - Task planner
apps/server/src/memory/planner.ts - Agent runner
apps/server/src/runner-factory.ts - Codex session
apps/server/src/codex-runner.ts - Trace summaries
apps/server/src/trace-summary.ts
Memory governance
- Memory pipeline
apps/server/src/memory/pipeline.ts - Topic segments
apps/server/src/memory/topic-segment.ts - Segment buffers
apps/server/src/memory/task-buffer.ts - Note extraction
apps/server/src/memory/consolidator.ts - Extractor client
apps/server/src/memory/extractor-client.ts - Recipient recognition
apps/server/src/memory/recognizer.ts - Safety checks
apps/server/src/memory/safety.ts - Review decisions
apps/server/src/memory/review.ts - Memory landing
apps/server/src/memory/landing.ts
State and workspaces
- Grant ledger
apps/server/src/memory/ledger.ts - JSON store
apps/server/src/store.ts - Agent workspaces
apps/server/src/workspace.ts
Other components
- Operator
- Ark model API
- Codex runtime
Connections 30
- Operator → Web workspace: operates
- Web workspace → HTTP client: requests
- Group task views → HTTP client: polls tasks
- Memory views → HTTP client: polls status
- HTTP client → HTTP routes: HTTP calls
- HTTP routes → Agent service: dispatches
- Agent service → JSON store: reads/writes
- Agent service → Agent workspaces: initializes
- Agent service → Group orchestration: starts tasks
- Group orchestration → Task planner: plans DAG
- Group orchestration → Agent runner: runs nodes
- Agent runner → Codex session: starts sessions
- Codex session → Codex runtime: executes
- Group orchestration → JSON store: records traces
- Group orchestration → Memory pipeline: flushes memory
- Memory pipeline → Segment buffers: builds buffers
- Segment buffers → JSON store: reads spans
- Memory pipeline → Note extraction: extracts notes
- Note extraction → Extractor client: requests extraction
- Extractor client → Ark model API: calls model
- Memory pipeline → Recipient recognition: routes recipients
- Memory pipeline → Safety checks: checks notes
- Memory pipeline → Review decisions: processes candidates
- Review decisions → Memory landing: lands or revokes
- Review decisions → Grant ledger: records decisions
- Review decisions → JSON store: updates notes
- Memory landing → Agent workspaces: writes files
- Grant ledger → JSON store: appends records
- Agent service → Memory landing: serves memory views
- Agent service → Grant ledger: serves audit views