https://github.com/bobmatnyc/terminator
Remote terminal control system with AI assistance - Control tmux and iTerm2 sessions via REST API with LLM-powered intelligent assistance
https://github.com/bobmatnyc/terminator
ai cli fastapi iterm2 llm python remote-control terminal tmux
Last synced: 5 months ago
JSON representation
Remote terminal control system with AI assistance - Control tmux and iTerm2 sessions via REST API with LLM-powered intelligent assistance
- Host: GitHub
- URL: https://github.com/bobmatnyc/terminator
- Owner: bobmatnyc
- Created: 2025-12-08T01:32:06.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-01-02T04:02:56.000Z (6 months ago)
- Last Synced: 2026-01-09T09:14:36.317Z (6 months ago)
- Topics: ai, cli, fastapi, iterm2, llm, python, remote-control, terminal, tmux
- Language: Python
- Size: 1.79 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Terminator
Remote terminal control system with AI assistance.
## Overview
Terminator provides remote terminal control capabilities through:
- **Terminal Adapters**: Support for tmux and iTerm2
- **REST API**: FastAPI-based control interface
- **LLM Integration**: Local and cloud LLM support for intelligent assistance
- **Security**: Risk classification and command approval
## Quick Start
### Prerequisites
- Python 3.11+
- tmux (for tmux adapter)
- iTerm2 (for iTerm2 adapter, macOS only)
### Installation
```bash
# Clone and enter project
cd terminator
# Create virtual environment
python -m venv .venv
source .venv/bin/activate
# Install dependencies
pip install -e ".[dev]"
# Copy environment template
cp .env.example .env
```
### Verify Installation
```bash
# Run the hello world verification script
python -m scripts.runner poc.hello_world
```
## Project Structure
```
terminator/
├── src/terminator/ # Main application
│ ├── adapters/ # Terminal adapters (tmux, iTerm2)
│ ├── core/ # Core business logic
│ ├── api/ # REST API layer
│ └── llm/ # LLM integration
├── scripts/ # POC and utility scripts
├── tests/ # Test suite
└── docs/ # Documentation
```
## Development
```bash
# Run tests
pytest
# Run with coverage
pytest --cov=server
# Type checking
mypy src
# Linting
ruff check src
```
## License
MIT