How waylliam1988/codey works
Codey is a local-first AI coding and research workspace. A user submits work through the local UI or CLI; the application coordinates a task run, connects a browser-based or local model, and mediates project actions through tools and policies. Coding runs can verify changes and provide completion evidence; research runs plan searches, inspect sources, and assess evidence; review and local memory are additional capabilities. The graph reflects README-described flows and relationships visible in the supplied excerpts or SOURCE INDEX; unsampled implementation details are not inferred.
Main entry points: task_run.py Task run loop · server.py Local UI server · catalog.py Provider catalog · pipeline.py Research pipeline
Components 23
User entry
- Local UI server
codey/app/server.py - CLI
codey/app/cli.py
Task orchestration
- Task submission
codey/app/task_submit.py - Task run loop
codey/operations/task_run.py - Task state contract
codey/operations/task_state.py
Model and workspace execution
- Provider catalog
codey/providers/catalog.py - Browser provider worker
codey/providers/worker.py - Browser automation
codey/automation/browser.py - Local model adapter
codey/providers/local_openai.py - Tool runtime
codey/toolchain/runtime.py - Project workspace context
codey/workspace/setup_context.py
Verification and review
- Completion proof
codey/completion/engine.py - Verification policy
codey/completion/verification_policy.py - Review service
codey/app/review_service.py
Research
- Research pipeline
codey/research/pipeline.py - Query planner
codey/research/query_planner.py - Evidence runtime
codey/research/evidence_runtime.py - Source trust
codey/research/source_trust.py
Local state and memory
- Ghost memory and work queue
codey/ghost/work_queue.py - Knowledge index
codey/knowledge/index.py - Local store
codey/storage/local_store.py - Session log
codey/runtime/log/session_log.py
Other components
- User
Connections 23
- User → Local UI server: uses
README.md - User → CLI: uses
README.md - Local UI server → Task submission: submits runs
codey/app/server.py - CLI → Task submission: submits tasks
- Task submission → Task run loop: starts run
- Task run loop → Task state contract: coordinates through
codey/operations/task_state.py - Task run loop → Provider catalog: selects provider
- Provider catalog → Browser provider worker: connects browser provider
codey/providers/worker.py - Browser provider worker → Browser automation: runs automation
codey/providers/worker.py - Provider catalog → Local model adapter: supports local model
- Task run loop → Tool runtime: executes tools
- Tool runtime → Project workspace context: accesses project
- Project workspace context → Verification policy: informs checks
codey/workspace/setup_context.py - Verification policy → Completion proof: supplies checks
codey/completion/engine.py - Task run loop → Review service: can request review
- Task run loop → Research pipeline: runs research tasks
README.md - Research pipeline → Query planner: plans follow-up
codey/research/pipeline.py - Research pipeline → Evidence runtime: checks evidence
codey/research/pipeline.py - Evidence runtime → Source trust: uses source trust
codey/research/pipeline.py - Task run loop → Ghost memory and work queue: supports local memory
- Task state contract → Knowledge index: coordinates knowledge store
codey/operations/task_state.py - Local UI server → Local store: uses local state
codey/app/server.py - Session log → Local store: persists locally
codey/runtime/log/session_log.py