Desktop app

CommandUI AI-native shell.

Real terminal. Semantic input. You review every command before it runs.

Download Read the Handbook

Command

git status --short

Ask

"show me changed files" → git status --short

Workflow

git add → git commit → git push

Install

Windows (MSI)

# Download from GitHub Releases
https://github.com/mcp-tool-shop-org/commandui/releases/latest

Scoop

scoop bucket add mcp-tool-shop https://github.com/mcp-tool-shop-org/scoop-bucket
scoop install commandui

winget

winget install mcp-tool-shop.CommandUI

Features

Terminal power without terminal hostility.

Real Shell

Full PTY sessions with stdout/stderr streaming, exit codes, cwd tracking, and multi-session tabs. Not a wrapper — a real terminal.

Semantic Input

Describe intent in natural language. The AI planner generates a shell command with explanation, risk assessment, and assumptions. You review before anything runs.

Risk-Tiered Safety

Low-risk commands flow. Medium-risk commands ask. High-risk commands require explicit confirmation. Nothing destructive executes without your approval.

Edit Before Run

Every generated command is editable. Modify it, add flags, change paths — then approve. History records both the original and your edit.

Workflow Promotion

Repeat a command sequence three times and the system suggests saving it as a workflow. Promoted workflows feed back into the planner for better future suggestions.

Project Memory

Learns your preferred tools, directories, and command patterns. Confidence-scored, visible, editable, deletable. Feeds the planner so it stops acting like a stranger.

Quick Start

Clone & install

git clone https://github.com/mcp-tool-shop-org/commandui.git
cd commandui
pnpm install

Browser preview

pnpm dev
# Opens at http://localhost:5176
# Mock bridge simulates all backend ops

Full desktop app

cd apps/desktop
pnpm tauri:dev
# Rust backend + real PTY shell

Run tests

pnpm typecheck
pnpm test
cd apps/desktop/src-tauri && cargo test

Architecture

Six layers, clear boundaries, local-first.

Tauri v2 + React 19

Rust backend for PTY management, SQLite persistence, and Ollama LLM integration. React frontend with Zustand state management and xterm.js terminal.

Monorepo Packages

Domain types, API contracts, and state stores as separate packages. Dependencies flow downward. Frontend never touches Rust directly.

Ollama-First Planning

Local LLM generates command plans with context-aware prompts. Falls back to mock planner when Ollama is unavailable. Zero cloud dependency.