OpenTerminal is a local-first AI computer operator designed for reliable control over terminal, files, scripts, services, containers, and networking. The system prioritizes reliability over complexity, ensuring secure and predictable interactions with system components.
- Implemented Components: CLI interface, Ollama local model support, agent runtime loop, shell execution tool, filesystem tools, permission checking, audit logging
- Documented Architecture: Full architecture documentation available in architecture.md
OpenTerminal's architecture consists of:
- Daemon: Central control unit managing agent lifecycles
- CLI: Command-line interface for user interaction
- Agent Runtime: Executes tasks with permission constraints
- Tool Router: Directs requests to appropriate system tools
- Permission Engine: Enforces security policies (SAFE/APPROVAL/BLOCKED)
- Audit Logs: Comprehensive action tracking and monitoring
The system follows a validated flow from user intent to execution, with all operations requiring permission checks and logging.
- Run CLI:
./cmd/openterminal - Build daemon:
go build -o openterminal - View architecture:
markdown docs/architecture.md