How aidenbarrett/local-code-agent works
Local Code Agent is a local-first coding worker: the model proposes work, while deterministic controllers own admission, permissions, execution, verification, durable state, and verdicts. The principal flow starts in the Session Hub, passes through durable task admission and the task controller/orchestrator, uses bounded repository tools, then independently verifies and records the result. Separate branches provide model/runtime serving and durable watch jobs. The README documents product-level links; sampled excerpts and the source index support only some internal calls, so unsampled relationships are omitted or shown as documented.
Main entry points: orchestrator.py Agent orchestrator · task_controller.py Task controller · client.py LLM client · durable_task_controller.py Durable task executor
Components 29
Session interface
- Session Hub
internal/local_agent/session/textual_live_app.py - Conversation gateway
internal/local_agent/session/conversation_gateway.py
Deterministic control
- Task admission
internal/local_agent/session/task_admission.py - Durable task executor
internal/local_agent/session/durable_task_controller.py - Task controller
internal/local_agent/session/task_controller.py - Agent orchestrator
internal/local_agent/agent/orchestrator.py - Agent context
internal/local_agent/agent/context.py - Agent policy
internal/local_agent/agent/policy.py - Agent skills
internal/local_agent/agent/skills.py - Agent state
internal/local_agent/agent/state.py - Configuration
internal/local_agent/config.py - Task outcomes
internal/local_agent/session/contracts.py
Tools and verification
- Tool registry
internal/local_agent/tools/__init__.py - Tool primitives
internal/local_agent/tools/tool_primitives.py - Process runner
internal/local_agent/tools/process_runner.py - Independent verification
internal/local_agent/verification.py - Proof binding
internal/local_agent/session/proof_binding.py
Durable state
- Durable session service
internal/local_agent/session/session_event_service.py - Session store
internal/local_agent/session/session_store.py - Run provenance
internal/local_agent/provenance.py - Watch lifecycle
internal/local_agent/watch/service.py - Fixed watch runner
internal/local_agent/watch/fixed_watch_runner.py - Watch stores
internal/local_agent/watch/job_store.py
Model and runtime
- LLM client
internal/local_agent/llm/client.py - Model tiers
internal/local_agent/llm/model_tiers.py - Model protocol
internal/local_agent/llm/protocol.py - Inference endpoint
internal/native_endpoint/src/main.cpp
Other components
- Engineer
- OpenAI-compatible model endpoint
Connections 25
- Engineer → Session Hub: submits request
README.md - Session Hub → Conversation gateway: handles conversation
- Conversation gateway → Task admission: admits task
- Task admission → Durable task executor: authorizes execution
- Durable task executor → Task controller: invokes controller
internal/local_agent/session/durable_task_controller.py - Task controller → Agent orchestrator: runs worker
internal/local_agent/session/task_controller.py - Agent orchestrator → Agent context: gathers context
internal/local_agent/agent/orchestrator.py - Agent orchestrator → Agent policy: applies policy
internal/local_agent/agent/orchestrator.py - Agent orchestrator → Agent skills: activates skill
internal/local_agent/agent/orchestrator.py - Agent orchestrator → Agent state: updates state
internal/local_agent/agent/orchestrator.py - Agent orchestrator → Tool registry: dispatches tools
internal/local_agent/agent/orchestrator.py - Tool registry → Tool primitives: builds registry
internal/local_agent/tools/__init__.py - Task controller → Independent verification: verifies run
internal/local_agent/session/task_controller.py - Task controller → Proof binding: binds proof
internal/local_agent/session/task_controller.py - Task controller → Task outcomes: projects outcome
internal/local_agent/session/task_controller.py - Durable task executor → Run provenance: captures identity
internal/local_agent/session/durable_task_controller.py - Durable session service → Session store: commits events
internal/local_agent/session/session_event_service.py - Watch lifecycle → Watch stores: reads and writes
internal/local_agent/watch/service.py - Watch lifecycle → Fixed watch runner: creates runner
internal/local_agent/watch/service.py - Agent orchestrator → LLM client: requests inference
internal/local_agent/agent/orchestrator.py - LLM client → Model protocol: uses protocol
internal/local_agent/llm/client.py - Model tiers → LLM client: selects client
internal/local_agent/llm/model_tiers.py - LLM client → OpenAI-compatible model endpoint: sends chat request
README.md - OpenAI-compatible model endpoint → Inference endpoint: may be served by
- Tool registry → Process runner: exposes execution tools