How ragungnoviandri/debigbos works
de BigBos is an AI-powered CLI coding assistant. The main workflow is a user query entering through the CLI or chat UI, reaching the agent’s conversation/tool loop, and returning a model response; tool calls can inspect or change the workspace. Sessions, memory, skills, and soul shape ongoing conversations, while provider implementations connect to model services. The README documents further capabilities such as subagents, compaction, and session import that are not fully visible in the sampled source; those are represented only where paths and relationships are supported.
Main entry points: agent.py Agent Loop · home.py Chat Screen · registry.py Tool Registry · main.py CLI Commands
Components 22
User Interface
- CLI Commands
debigbos/main.py - Textual App
debigbos/tui/app.py - Chat Screen
debigbos/tui/screens/home.py
Conversation Runtime
- Agent Loop
debigbos/core/agent.py
Models And Tools
- Provider Registry
debigbos/models/registry.py - Model Providers
debigbos/models/provider.py - OpenCode Provider
debigbos/models/opencode_provider.py - Tool Registry
debigbos/tools/registry.py - File Tools
debigbos/tools/file_tools.py - Bash Tool
debigbos/tools/bash_tool.py - Web Tool
debigbos/tools/web_tool.py
Assistant State
- Sessions
debigbos/core/session.py - Persistent Memory
debigbos/core/memory.py - Soul Persona
debigbos/core/soul.py - Skills
debigbos/core/skills.py - Configuration
debigbos/config/manager.py - Credential Store
debigbos/config/auth.py
Workspace Features
- Git Integration
debigbos/tools/git_utils.py
Other components
- User
- Model Service
- Project Files
- Workspace Git
Connections 24
- User → CLI Commands: runs commands
- User → Chat Screen: sends messages
- CLI Commands → Textual App: starts interactive UI
- Textual App → Chat Screen: shows chat screen
- Chat Screen → Agent Loop: submits prompts
- Agent Loop → Chat Screen: streams responses
- Agent Loop → Provider Registry: selects provider
- Provider Registry → Model Providers: creates provider
- Model Providers → OpenCode Provider: implements provider
- OpenCode Provider → Model Service: sends model requests
- Agent Loop → Tool Registry: dispatches tool calls
- Tool Registry → File Tools: invokes handlers
- Tool Registry → Bash Tool: invokes handlers
- Tool Registry → Web Tool: invokes handlers
- File Tools → Project Files: reads and writes
- Bash Tool → Project Files: runs workspace commands
- Agent Loop → Sessions: manages conversations
- Agent Loop → Persistent Memory: loads and saves memories
- Agent Loop → Soul Persona: builds assistant prompt
- Agent Loop → Skills: loads skills
- Agent Loop → Configuration: uses runtime settings
- Configuration → Credential Store: resolves credentials
- Chat Screen → Git Integration: shows git status
- Git Integration → Workspace Git: reads repository state