TerminAI

The safe, local-first AI operator for your terminal.

Stop copy-pasting from ChatGPT. TerminAI is the CLI that operates your machine with permissions you control.

Runs on Windows/Linux/macOS using the models you already trust (Gemini, OpenAI, Local LLMs). Designed for real system changes or user workflows - governed, reviewable, and reversible.

<div align="center"> <img src="docs-terminai/assets/terminai-banner.svg" alt="TerminAI Banner" width="100%"> </div> <p align="center"> <a href="https://github.com/Prof-Harita/terminaI/actions/workflows/ci.yml"><img src="https://github.com/Prof-Harita/terminaI/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <img src="https://img.shields.io/badge/Node.js-20+-339933" alt="Node.js 20+"> <img src="https://img.shields.io/badge/License-Apache%202.0-green" alt="License"> </p>

TerminAI is an AI-powered system operator.
You describe what you want; TerminAI inspects your machine, proposes a plan, and executes it through governed tools with a deterministic approval ladder and an audit trail.

Status: Public Preview (v0.x)
The core operator loop is rock-solid. CLI is the canonical surface. Desktop/Voice/A2A are optional and still being hardened across platforms. Expect power; expect rough edges. Contributions welcome.

---

What this is / what this is not

This is:

• A local-first operator runtime: intent → governed plan → approvals → execution → audit log.
• A real terminal operator (true PTY): it can handle interactive sessions (sudo prompts, ssh, vim/htop-style flows).
• A model-flexible setup: choose a provider you already use (including OpenAI-compatible endpoints and local gateways).

<div align="center"> <img src="docs-terminai/assets/Kooha_combined_cropped.gif" alt="TerminAI Demo" width="100%"> </div> <details> <summary><strong>🌍 1. Plan a complex trip (Research & Output)</strong></summary> </details> <details> <s...