Ai Commander

AI Commander

Multi-interface AI session management system written in Rust.

Control AI coding sessions from TUI, REPL, or Telegram with support for multiple adapters including Claude Code, MPM, Aider, and plain shell sessions.

Features

Core

• Multi-interface AI session management - Control AI coding sessions from TUI, REPL, or Telegram
• Adapter system - Support for Claude Code, MPM, Aider, and plain shell sessions
• Project management - Create, connect, disconnect, and manage multiple projects
• Tmux integration - Sessions run in tmux for persistence and multiplexing

TUI

• Interactive terminal UI with ratatui
• Session list view (F3)
• Inspect mode for live tmux view (F2)
• Text wrapping for long outputs
• Tab autocomplete for slash commands
• Clickable session links - click session names in /list output to connect

GUI (Graphical User Interface) 🪟

• Desktop application with all TUI features and better discoverability
• Real-time session list with auto-refresh (2s interval)
• Chat interface with Claude and auto-scroll
• Bot daemon control (start/stop/status with 5s monitoring)
• Keyboard shortcuts (Enter to send, Shift+Enter for newlines)
• Lightweight binary (~10MB, Tauri 2.x + Svelte)
• Cross-platform support (macOS, Linux, Windows)
• Documentation: See `docs/GUI.md` for comprehensive guide

Telegram Bot

• Remote session control from Telegram
• Secure pairing with 6-character codes
• Auto-start bot daemon on /telegram command
• Auto-build binary if not found
• Auto-restart bot on app launch
• Response summarization for mobile (via OpenRouter)
• Inline keyboard buttons - tap session names in /list or /sessions to connect
• Forum Topics support - create dedicated topics for different sessions in group chats

Installation

Quick Start - Local Deployment (macOS)

For stable production-like local setup with auto-starting services:

cd /Users/masa/Projects/ai-commander

# Build and inst