Your Personal AI Assistant

5 Engines · One Brain · Always On

Get your personal AI assistant in 2 lines

$ npm install -g cli-jaw
$ jaw serve
Get Started ⭐ GitHub
🪟 Windows? 🍎 What is Terminal?
Tests npm TypeScript Node Docker Platforms
Scroll

See It in Action

Five AI Engines, One Roof

Pick whichever you have. CLI-JAW auto-detects and falls back gracefully. Even one engine is enough.

🟣
Claude
claude-sonnet-4-6
Paid
🟢
Codex
gpt-5.3-codex
Paid
🔵
Gemini
gemini-2.5-pro
Paid
OpenCode
claude-opus-4-6
🆓 Free
🟠
Copilot
gpt-4.1
🆓 Free

Engine down? → Next one picks up automatically. Zero downtime.

Why CLI-JAW?

Not just another chatbot. A full-stack personal assistant with real capabilities.

🛡️
TOS-Safe

Uses official CLIs only — no API key scraping, no reverse engineering, no ban risk.

🎭
PABCD Orchestration

DB-persisted FSM pipeline — Plan → Audit → Build → Check → Done. Workers are read-only. You approve every phase.

📦
108 Skills

Browser automation, document generation, Telegram, memory, GitHub, Notion — ready out of the box.

🔄
Smart Retry

429 rate-limited? Same engine retries once, then auto-falls back to the next available engine. Zero downtime.

📱
Telegram Bot

Chat from your phone. Send voice, photos, files. Get AI responses, generated docs, and screenshots back.

🔌
MCP Ecosystem

Install MCP once → syncs to all 6 AI engines instantly. One config, six agents.

🖥️
Cross-Platform

macOS, Linux, WSL, Docker. ENOENT-safe spawn, auto-detection, container isolation.

PABCD — AI That Plans Before It Builds

A DB-persisted finite state machine that enforces planning, auditing, and verification. No cowboy coding — every phase requires your approval.

📝
Plan
Diff-level implementation plan. Stops for your review.
🔍
Audit
Read-only worker verifies feasibility. No files touched.
🔨
Build
Boss implements. Worker verifies. Self-heals on failure.
Check
Final verification — type-check, docs, consistency.
🏁
Done
Summary of all changes. Returns to idle.

🛡️ Workers Are Read-Only

Audit and verification workers cannot modify files. They inspect, report, and recommend — but never touch your code.

⛔ Hard Stop at Every Phase

The AI cannot self-advance. You review and approve each transition. No runaway agents, no surprise changes.

💾 DB-Persisted State

State survives server restarts. CLI and Web UI share the same FSM — resume from any interface.

⚡ Parallel-Safe Dispatch

Independent subtasks run concurrently via Promise.all with automatic file-overlap detection and sequential fallback.

# Activate orchestration
jaw orchestrate
# → P: Planning... (writes plan, waits for approval)
# → A: Audit... (worker verifies plan)
# → B: Build... (implements + verifies)
# → C: Check → D: Done ✅

Runs Everywhere

If your OS has a CLI, CLI-JAW works there. No exceptions.

🍎 macOS
🐧 Linux
🔲 WSL
🐳 Docker
☁️ Cloud VMs
📦 CI/CD

🐳 Docker — Container Isolation

Run CLI-JAW in a Docker container for security isolation. AI agents cannot access host files. Non-root user, Chromium sandbox enabled by default.

Dockerfile Dockerfile.dev docker-compose.yml
# Quick start
docker compose up -d
# → http://localhost:3457

# Or build manually
docker build -t cli-jaw .
docker run -d -p 3457:3457 cli-jaw

Three Ways to Connect

Web UI, Terminal TUI, or Telegram. Same assistant, same memory, same skills.

CLI-JAW Web UI
CLI-JAW Terminal
CLI-JAW Telegram Bot
CLI-JAW Orchestration

Up and Running in 30 Seconds

1
Install
npm install -g cli-jaw
2
Authenticate
# pick any one
copilot login
claude auth
codex login
gemini login
3
Launch
jaw serve
# → http://localhost:3457