How grim-sudo/automation works
Archon turns CLI, chatbot, or GUI requests into cross-platform automation, with separate routes for n8n workflows and Linux ISO builds. Its principal path is intent interpretation, command planning, workflow execution, then plugin or OS-adapter actions; AI model access supports planning and conversation. Other documented capabilities include project/DevOps/document generation, web automation, and file operations. The README documents these capabilities, but sampled source is partial, so the graph omits uncertain internal call wiring and represents only supported orchestration and integrations.
Main entry points: core/engine.py Core engine · workflow/engine.py Workflow engine · plugin_manager.py Plugin manager · chatbot.py Chatbot
Components 24
User interfaces
- Unified CLI
archon/_cli.py - GUI application
archon/ui/gui/app.py - Chatbot
archon/ui/chatbot.py
Intent and orchestration
- Core engine
archon/core/engine.py - Semantic NLP
archon/nlp/semantic_engine.py - Command parser
archon/parsers/command_parser.py - Workflow engine
archon/workflow/engine.py - Plugin manager
archon/core/plugin_manager.py
Automation capabilities
- Capability registry
archon/capabilities/registry.py - File and document actions
archon/capabilities/native/filesystem.py - Automation plugins
archon/plugins - OS adapters
archon/os_adapters/adapter_factory.py - Permission controls
archon/security/permission_manager.py
Specialized workflows
- n8n workflow bridge
archon/plugins/n8n_bridge/workflow_manager.py - Execution triggers
archon/plugins/n8n_bridge/trigger_engine.py - ISO build pipeline
archon/distro_builder/build_pipeline.py
AI services
- AI task planner
archon/ai/task_planner.py - Model manager
archon/ai/model_manager.py - Conversation context
archon/ai/context_manager.py
Other components
- User
- OpenRouter API
- n8n service
- Host operating system
- Kernel and ISO tools
Connections 27
- User → Unified CLI: submits command
- User → GUI application: submits request
- User → Chatbot: starts conversation
- Unified CLI → Core engine: dispatches
- GUI application → Core engine: uses engine
- Chatbot → Core engine: sends turns
- Core engine → Semantic NLP: analyzes intent
- Core engine → Command parser: parses command
- Core engine → AI task planner: requests plan
- Core engine → Workflow engine: executes workflow
- Workflow engine → Plugin manager: dispatches capability
- Core engine → Plugin manager: queries plugins
- Plugin manager → Automation plugins: loads and executes
- Plugin manager → Capability registry: resolves capability
- Workflow engine → OS adapters: performs OS actions
- Workflow engine → Permission controls: checks permissions
- OS adapters → Host operating system: operates on
- Automation plugins → File and document actions: provides file actions
- Automation plugins → n8n workflow bridge: routes workflow requests
- n8n workflow bridge → n8n service: calls REST API
- Execution triggers → n8n service: polls and receives callbacks
- Core engine → ISO build pipeline: builds distro
- ISO build pipeline → Kernel and ISO tools: builds ISO
- AI task planner → Model manager: requests completion
- Chatbot → Conversation context: maintains turns
- Model manager → OpenRouter API: sends model requests
- OpenRouter API → Model manager: returns completions