How surya20062425/void-cli works
Void is a terminal AI-agent CLI. Its main workflow takes a user’s chat request through the CLI, builds a model client, and runs an agent loop that can dispatch model-requested tools before returning text. Separate command surfaces manage providers and fallbacks, saved sessions, installed skills, and scheduled jobs. The README documents these capabilities; some command implementations and runtime wiring are unsampled, so their links are shown only where documented or indexed.
Main entry points: cli.py Command interface · providers.py Provider resolution · agent.py Agent loop · registry.py Tool registry
Components 20
CLI experience
- Command interface
void/cli.py - Terminal theme
void/theme.py
Agent runtime
- Agent loop
void/agent.py - Tool registry
void/tools/registry.py - System tools
void/tools/system.py - Web tools
void/tools/web.py
Models and providers
- Model client
void/model.py - Configuration
void/config.py - Provider resolution
void/providers.py - Model commands
void/commands/model_cmd.py - Auth commands
void/commands/auth_cmd.py - Fallback commands
void/commands/fallback_cmd.py
Agent management
- Skill management
void/commands/skills_cmd.py - Session commands
void/commands/sessions_cmd.py - Session store
void/sessions.py - Scheduled jobs
void/commands/cron_cmd.py - Cron job store
void/commands
Other components
- CLI user
- OpenAI-compatible API
- DuckDuckGo
Connections 25
- CLI user → Command interface: runs commands
README.md - Command interface → Agent loop: starts chat
README.md - Agent loop → Model client: requests completion
void/agent.py - Model client → OpenAI-compatible API: calls API
void/model.py - Model client → Configuration: reads defaults
void/model.py - Agent loop → Tool registry: gets schemas; dispatches calls
void/agent.py - Agent loop → Skill management: loads skill context
void/agent.py - Tool registry → System tools: discovers tools
void/tools/registry.py - Tool registry → Web tools: discovers tools
void/tools/registry.py - Web tools → DuckDuckGo: searches web
README.md - Command interface → Configuration: reads and sets
void/cli.py - Command interface → Provider resolution: resolves provider
void/cli.py - Provider resolution → Configuration: reads and saves
void/providers.py - Command interface → Model commands: routes model commands
README.md - Command interface → Auth commands: routes auth commands
README.md - Command interface → Fallback commands: routes fallback commands
README.md - Auth commands → Provider resolution: manages providers
void/commands/auth_cmd.py - Fallback commands → Provider resolution: manages fallback chain
void/commands/fallback_cmd.py - Model commands → Provider resolution: manages models
README.md - Command interface → Session commands: routes sessions commands
README.md - Session commands → Session store: reads and writes sessions
void/commands/sessions_cmd.py - Command interface → Skill management: routes skill commands
README.md - Command interface → Scheduled jobs: routes cron commands
README.md - Scheduled jobs → Cron job store: reads and writes jobs
README.md - Command interface → Terminal theme: uses terminal styling
void/cli.py