How luchng31/autogdb-agent works
AutoGDB Agent is a plugin-based debugging assistant. Its primary workflow is a user starting a CLI debugging session, providing a target or command, and receiving debugging or analysis output. The README also documents protocol sending, extensible debugger and analyzer plugins, workflows, and report formats. Edges reflect the sampled CLI, session, plugin, analyzer, and protocol behavior plus explicitly documented component roles; unsampled implementations limit finer-grained wiring.
Main entry points: session.py Debug Session · agent.py Agent · plugin_manager.py Plugin Manager · cli.py CLI
Components 22
User Entry
- CLI
src/autogdb_agent/cli.py
Agent Coordination
- Agent
src/autogdb_agent/core/agent.py - Debug Session
src/autogdb_agent/core/session.py - Configuration
src/autogdb_agent/core/config.py - Tool Registry
src/autogdb_agent/core/tool_registry.py - Tool Runner
src/autogdb_agent/core/tool_runner.py - Plugin Manager
src/autogdb_agent/core/plugin_manager.py - Debug Workflows
src/autogdb_agent/core
Debugging Tools
- Debugger Tool
src/autogdb_agent/tools/debugger.py - Crash Analysis
src/autogdb_agent/tools/analyzer.py - Memory Inspector
src/autogdb_agent/tools/memory_inspector.py - Disassembler
src/autogdb_agent/tools/disassembler.py - Stack Trace
src/autogdb_agent/tools/stack_trace.py - Protocol Sender
src/autogdb_agent/tools/protocol_sender.py - Debug Reports
src/autogdb_agent/tools
Plugins And Protocols
- GDB Plugin
src/autogdb_agent/plugins/debuggers/gdb_plugin.py - Crash Analyzer Plugin
src/autogdb_agent/plugins/analyzers/crash_analyzer_plugin.py - Protocol Plugins
plugins/protocols
Other components
- Engineer
- Debug Target
- Protocol Endpoint
- Debugger Process
Connections 18
- Engineer → CLI: enters commands
- CLI → Agent: starts and queries
- Agent → Configuration: loads settings
- Agent → Debug Session: creates sessions
- Debug Session → Plugin Manager: gets debugger plugins
- Debug Session → Tool Registry: executes commands
- Tool Registry → Tool Runner: dispatches tools
- Plugin Manager → GDB Plugin: loads plugins
- Plugin Manager → Crash Analyzer Plugin: loads plugins
- GDB Plugin → Debugger Tool: executes with
- Crash Analyzer Plugin → Crash Analysis: executes with
- Debugger Tool → Debugger Process: controls
- Debugger Process → Debug Target: debugs
- Protocol Sender → Protocol Plugins: sends through
- Protocol Plugins → Protocol Endpoint: exchanges data
- Debug Session → Debug Workflows: supports workflows
- Crash Analysis → Debug Reports: formats analysis
- Stack Trace → Debug Reports: formats traces