How rohith-s-hub/oblivion-agent works
Oblivion is a terminal-native AI coding agent: a user submits a prompt through the TUI, M.E.E.R.A. reasons with an LLM, parses tool actions, applies safety controls, and returns an answer or performs code work. Its hybrid code search, voice interaction, MCP server, and 8085 simulator are distinct product capabilities. Several connections below are documented in the README or SOURCE INDEX; unsampled implementation details are not inferred.
Main entry points: core.py M.E.E.R.A. loop · registry.py Tool registry · app.py Terminal UI · sim_screen.py 8085 simulator UI
Components 27
User interfaces
- Terminal UI
ui/app.py - 8085 simulator UI
ui/sim_screen.py
Agent reasoning
- M.E.E.R.A. loop
agent/core.py - Agent runtime
agent/runtime.py - Model fallback
agent/llm.py - Response parser
agent/parser.py - Reasoning prompts
agent/brain.py - Plan guard
agent/plan_guard.py - Action permissions
agent/permissions.py - Knowledge packs
knowledge/injector.py
Coding and search
- Tool registry
tools/registry.py - Workspace tools
tools/filesystem.py - Diff previews
tools/diff.py - Atomic editing
tools/batch_edit.py - Hybrid search
agent/rag.py - AST chunking
agent/code_chunker.py - Symbol index
agent/symbol_index.py
Voice and MCP
- Voice interaction
agent/voice.py - Wake-word listener
agent/wake_word.py - MCP tool service
mcp_server/core.py - MCP transports
mcp_server/transports
State and simulator
- Session storage
db/store.py - Assembler
simulator/assembler.py - 8085 CPU
simulator/cpu8085.py
Other components
- Developer
- External editor
- LLM providers
Connections 26
- Developer → Terminal UI: submits prompt
- Terminal UI → M.E.E.R.A. loop: starts agent
ui/app.py - M.E.E.R.A. loop → Model fallback: requests completion
agent/core.py - Model fallback → LLM providers: calls models
agent/llm.py - M.E.E.R.A. loop → Response parser: parses response
agent/core.py - M.E.E.R.A. loop → Reasoning prompts: builds reasoning prompt
agent/core.py - M.E.E.R.A. loop → Tool registry: dispatches tools
agent/core.py - M.E.E.R.A. loop → Plan guard: checks plans
agent/core.py - Agent runtime → Action permissions: checks action tier
agent/runtime.py - Agent runtime → Tool registry: dispatches tools
agent/runtime.py - Tool registry → Workspace tools: invokes workspace tools
tools/registry.py - Tool registry → Atomic editing: invokes batch edits
tools/registry.py - M.E.E.R.A. loop → Diff previews: previews changes
agent/core.py - Tool registry → Hybrid search: uses code search
tools/registry.py - Hybrid search → AST chunking: chunks source
agent/rag.py - Hybrid search → Symbol index: updates symbols
agent/rag.py - M.E.E.R.A. loop → Knowledge packs: adds domain context
agent/core.py - Terminal UI → Session storage: stores sessions
ui/app.py - Terminal UI → Voice interaction: starts voice input
ui/app.py - Terminal UI → Wake-word listener: controls listening
ui/app.py - External editor → MCP transports: connects over MCP
- MCP transports → MCP tool service: routes requests
mcp_server/transports/sse.py - MCP tool service → Tool registry: dispatches tools
mcp_server/core.py - Developer → 8085 simulator UI: opens simulator
- 8085 simulator UI → Assembler: assembles programs
ui/sim_screen.py - 8085 simulator UI → 8085 CPU: runs instructions
ui/sim_screen.py