How thirumalai-tech-developer/kratos-agent works
Kratos Agent is a terminal-based autonomous coding agent. A user request enters through the CLI, is planned and assembled into model context, sent to an LLM, and may trigger approval-gated workspace tools; the runtime then verifies work, records session history, and presents progress in the TUI. The graph preserves documented capabilities such as skills, MCP, memory, tool forging, and engineering workflows. Several subsystems are represented by their tree paths because their source was not excerpted; edges are limited to README statements and indexed references.
Main entry points: main.py Runtime composition · agent_loop.py Agent loop · cli.py Terminal CLI · client.py LLM client
Components 25
User interface
- Terminal CLI
src/kratos_agent/cli.py - Live TUI
src/kratos_agent/tui/live_renderer.py
Agent runtime
- Runtime composition
src/kratos_agent/main.py - Agent loop
src/kratos_agent/core/agent_loop.py - Task planning
src/kratos_agent/core/planner.py - Task state
src/kratos_agent/core/task_manager.py - Instruction assembly
src/kratos_agent/core/instruction_engine.py - Context assembly
src/kratos_agent/core/context_pipeline.py - Approval gates
src/kratos_agent/core/approval_mode.py
Model gateway
- Chat model
src/kratos_agent/brain/chat_model.py - LLM client
src/kratos_agent/brain/client.py - LLM gateway
Workspace capabilities
- Workspace tools
src/kratos_agent/utils/tools.py - Verification
src/kratos_agent/core/verification_manager.py - Git workflows
src/kratos_agent/core/git_tools.py - Tool forging
src/kratos_agent/utils/tool_creator.py - Skills
src/kratos_agent/core/skills.py - MCP tools
src/kratos_agent/core/mcp_runtime.py - Review workflows
src/kratos_agent/core/prompt_library.py
State and feedback
- Session memory
src/kratos_agent/core/memory.py - Project memory
src/kratos_agent/core/project_memory.py - Session event store
src/kratos_agent/core/event_store.py - Runtime events
src/kratos_agent/core/event_bus.py - Latency tracking
src/kratos_agent/core/latency_tracker.py
Other components
- Developer
Connections 25
- Developer → Terminal CLI: submits request
README.md - Terminal CLI → Runtime composition: enters runtime
src/kratos_agent/main.py - Runtime composition → Agent loop: runs loop
src/kratos_agent/main.py - Agent loop → Task planning: plans tasks
src/kratos_agent/core/agent_loop.py - Agent loop → Context assembly: assembles context
src/kratos_agent/core/agent_loop.py - Agent loop → Task state: updates tasks
src/kratos_agent/core/agent_loop.py - Runtime composition → Instruction assembly: builds instructions
src/kratos_agent/main.py - Context assembly → Chat model: provides request
README.md - Chat model → LLM client: sends completion
src/kratos_agent/brain/__init__.py - LLM client → LLM gateway: posts requests
src/kratos_agent/brain/client.py - LLM client → Latency tracking: records metrics
src/kratos_agent/brain/client.py - Agent loop → Approval gates: checks permissions
README.md - Agent loop → Workspace tools: executes tools
README.md - Agent loop → Verification: verifies output
README.md - Runtime composition → Session memory: restores sessions
src/kratos_agent/main.py - Runtime composition → Session event store: opens session trace
src/kratos_agent/main.py - Agent loop → Runtime events: emits events
src/kratos_agent/core/agent_loop.py - Live TUI → Runtime composition: invokes runtime
src/kratos_agent/tui/live_renderer.py - Live TUI → Runtime events: renders events
src/kratos_agent/tui/live_renderer.py - Runtime composition → Skills: loads skills
src/kratos_agent/main.py - Runtime composition → MCP tools: configures MCP
src/kratos_agent/main.py - Runtime composition → Project memory: loads project memory
src/kratos_agent/main.py - Terminal CLI → Tool forging: creates tools
src/kratos_agent/cli.py - Terminal CLI → Git workflows: offers git workflows
src/kratos_agent/cli.py - Terminal CLI → Review workflows: offers review commands
src/kratos_agent/cli.py