How ambalavanan-m/ai-shell works
AI-Shell is a Linux command interpreter with a natural-language assistant, a human-reviewed safety pipeline, and system-programming analysis commands. Its principal workflow is user input → parsing and command generation → risk analysis and approval where AI is involved → execution. The README also documents built-ins, job control, macros, system information, compiler and ELF analysis, debugging, and error assistance. Only README.md is present, so implementation paths and undocumented call relationships cannot be established; edges below reflect documented behavior only.
Components 20
Shell Runtime
- Shell Loop
- Command Parser
- Built-in Commands
- Macro Processor
- History
AI And Safety
- AI Assistant
- AI Service
- Risk Analyzer
- Human Approval
- Error Assistant
System Analysis
- System Information
- Compiler Pipeline
- Assembly Analysis
- ELF Analyzer
- GDB Interface
Process Execution
- Command Executor
- Job Control
- Signal Handling
Other components
- User
- Linux Programs
Connections 22
- User → Shell Loop: enters commands
README.md - Shell Loop → Command Parser: parses input
README.md - Shell Loop → Built-in Commands: handles built-ins
README.md - Shell Loop → Macro Processor: expands macros
README.md - Shell Loop → History: records history
README.md - Command Parser → Command Executor: dispatches commands
README.md - Command Executor → Linux Programs: executes programs
README.md - Command Executor → Job Control: manages jobs
README.md - Job Control → Signal Handling: handles signals
README.md - User → AI Assistant: requests command
README.md - AI Assistant → AI Service: requests generation
README.md - AI Service → AI Assistant: returns candidate
README.md - AI Assistant → Command Parser: validates candidate
README.md - AI Assistant → Risk Analyzer: assesses command
README.md - Risk Analyzer → Human Approval: requests review
README.md - Human Approval → Command Executor: approves execution
README.md - User → System Information: requests system data
README.md - User → Compiler Pipeline: requests compilation analysis
README.md - Compiler Pipeline → Assembly Analysis: exposes assembly stage
README.md - User → ELF Analyzer: requests ELF analysis
README.md - User → GDB Interface: requests debugging
README.md - User → Error Assistant: requests error help
README.md