Demo

Try it right now (10 min)

Pick one of these prompts and paste it into TerminAI. (Click to copy the full prompt)

"Plan an itinerary for Paris. I am visiting as a tourist for 2 days next Saturday. I have already seen the big attractions (Eiffel, Louvre). Find me hidden gems and plan my trip hour-by-hour, including restaurants. Show it on a map. I will visit all these locations via the Metro. Once done, save the map-based visual output as a PDF."

"My graphics drivers seem unstable after the last OS update. Identify my GPU model, check the currently installed driver version, and find the correct latest stable driver. Propose a clean install plan and verify it before execution."

"Check the price of Bitcoin every 10 minutes. If it drops below $90,000, send a system notification and append the timestamp/price to ~/crypto_log.csv. Keep running this in the background until I stop it."

Vision

What if your computer could do things for you safely?

Not just suggesting commands. Not just generating scripts. Actually operating your system—diagnosing issues, fixing problems, and orchestrating workflows—with guardrails that make execution trustworthy.

For years, "internet help" meant: copy instructions from a chat window, paste into your terminal, and hope you didn't miss a step. Coding tools (Cursor, Aider, etc.) reduced that friction for software development—but the rest of your computer is still stuck in the copy/paste era.

TerminAI is the next interface: you state intent, it proposes a governed plan, you approve at the right level, and it executes with an audit trail. Fewer fragile steps. More outcomes—without handing your machine to an unchecked agent.

Why this exists

Computers are powerful, but operating them still requires memorizing syntax, hunting through logs, and repeating the same diagnosis steps.

TerminAI compresses the gap between intent and execution—without turning your machine into an uncontrolled "agent."

Intent → Governed plan → Approval → Execution → Audit

Who it's for

• Generalist users — “Review the largest files in my downloads folder, prioritizing the oldest first, i need to free up 200 GB of space.” “What is wrong with my internet; reset my adapter.” “Setup a HP printer.” "Monitor the stock price of NVDA and alert me when it hits xx$". "Why is my system so slow? Can you free up memory" "Can you install the best markdown viewer on my linux machine?". "I just re-installed Windows. Find specific drivers for my GPU and install them".
• Developers — “Set up my machine for this repo.” “Fix my dev environment.” “Explain what broke and how to recover.” "Install all the dependencies for this project"
• Tech purists — AI leverage with deterministic guardrails, explicit approvals, and tamper-evident logs.
• Professional engineers / DevOps — Remotely control your servers, repeatable workflows, headless-friendly CLI, safer execution, readable audit trails.

Two ways to use TerminAI

• CLI (canonical): for developers, power users, and headless environments.
• Desktop (preview): a Tauri wrapper around the same engine (GUI + voice surface). Linux/Windows are early; macOS is in progress. Treat as experimental until hardened.

The canonical command is: terminai.

What makes TerminAI different

AI system operation must be governed. TerminAI is built around that primitive.

• True PTY support: handles interactive applications correctly (sudo prompts, ssh sessions, vim/htop-like flows) via node-pty.
• Governed autonomy: a strict policy engine + deterministic approval ladder (A/B/C) replaces "yolo execution."
• Audit trail by default: structured JSONL logs for actions and intent tracking (local files you can review/replay).
• Provider flexibility: choose what you already use—Google, OpenAI sign-in, or any OpenAI-compatible /chat/completions endpoint (OpenRouter, local gateways, etc.).
• Deep extensibility: first-class support for MCP (tool connectors) and an optional Agent-to-Agent (A2A) control plane (preview).
• Local-first posture: core operation runs on your machine; no hosted relay is required. Any optional remote features are opt-in and under your control.

Read more: docs-terminai/why-terminai.md

Install

CLI (npm)

Prereqs: Node.js 20+

npm i -g @terminai/cli
terminai --version
terminai

If you don't see the CLI package yet (or want bleeding-edge), install from source below.

Desktop (installers) — preview

Download installers from GitHub Releases (desktop is in preview):

• https://github.com/Prof-Harita/terminaI/releases

Git clone and build (contributors / bleeding-edge)

git clone https://github.com/Prof-Harita/terminaI.git
cd terminaI
npm install
npm run build

Upgrade (if you installed earlier)

If you installed before the recent multi-provider updates, upgrade so you get the latest auth + platform parity.

• npm global:

  npm i -g @terminai/cli@latest
  terminai --version
  

• release installers: grab the latest from Releases and reinstall:
  • https://github.com/Prof-Harita/terminaI/releases
• source build:

  git pull
  npm install
  npm run build
  

Quick start (providers)

Run terminai and the wizard guides you through setup.

Google Gemini (default)

Fastest path for many users.

terminai
# Select "Google Gemini" → browser opens → sign in

Or use an API key:

# macOS/Linux
export TERMINAI_API_KEY="your-gemini-key"

# Windows (PowerShell)
$env:TERMINAI_API_KEY='your-gemini-key'

terminai

ChatGPT sign-in (OAuth) — preview

Use an OpenAI browser sign-in flow (similar to how Codex tooling supports "Sign in with ChatGPT").

terminai
# Select "ChatGPT Sign-in (OAuth)" → sign in with OpenAI

Note: this is still being hardened. If anything fails, attach logs (see below) and open an issue.

OpenAI-Compatible

Connect to OpenAI Platform, OpenRouter, Ollama gateways, or any /chat/completions endpoint.

# macOS/Linux
export OPENAI_API_KEY="sk-..."

# Windows (PowerShell)
$env:OPENAI_API_KEY='sk-...'

terminai
# Select "OpenAI Compatible" → enter base URL and model

Popular configurations:

• OpenAI: https://api.openai.com/v1
• OpenRouter: https://openrouter.ai/api/v1
• Local LLM gateway: http://localhost:11434/v1

See: docs-terminai/multi-llm-support.md

Use `/llm reset` to switch when inside. Note right now hot-swap is not fully
live. Please restart (Ctrl-C and npm run start or terminai) to apply changes.

The Sovereign Runtime (Safety & Architecture)

TerminAI operates on a 3-Layer Defense-in-Depth model to ensure that autonomous execution never becomes "unchecked access":

1. Cognitive Layer (The "Brain"): A PAC Loop (Plan-Act-Check) with multi-model consensus that verifies intent before proposing action.
2. Governance Layer (The "Guardrails"): A deterministic Policy Engine with an Approval Ladder (A/B/C) that forces explicit human sign-off for mutating or destructive actions.