aora

AI CLI agent with ratatui TUI — ChatGPT via Chromium CDP bridge.

Features

• Single Rust binary — no Node.js runtime required for the TUI
• ChatGPT integration — uses headless Chromium to drive chatgpt.com (no API keys)
• OpenCode-level UI — 3-panel layout with streaming canvas, sidebar, and input
• MCP protocol support — connect to external MCP servers for tool discovery
• Sub-agent system — delegate tasks to isolated sub-agents
• Incremental diff rendering — real-time code diff visualization
• Configurable — tui.json for themes, keybindings, and behavior

Installation

npm install -g aora

Or build from source:

git clone https://github.com/yourusername/aora.git
cd aora
cargo build --release
./target/release/aora

Usage

aora

Keybindings

• Ctrl+q — Quit
• Enter — Submit message
• Shift+Up/Down — Scroll canvas
• PageUp/PageDown — Page scroll
• Ctrl+l — Clear screen
• Ctrl+n — New session
• Ctrl+b — Toggle sidebar

Commands

• /help — Show available commands
• /status — Show session status
• /mode — Switch between plan/act modes
• /clear — Clear the screen
• /exit — Exit aora
• /new — Create a new session
• /sessions — List sessions
• /diff — Show git diff
• /search — Search code
• /compact — Compact context

Configuration

Create ~/.config/aora/tui.json to customize:

{
  "theme": {
    "name": "default",
    "colors": {
      "primary": "#00FFFF",
      "secondary": "#808080"
    }
  },
  "keybindings": {
    "quit": "Ctrl+q",
    "submit": "Enter"
  },
  "layout": {
    "canvas_percentage": 70,
    "sidebar_percentage": 30
  }
}

Requirements

• Chromium/Chrome — installed and accessible in PATH
• Linux/macOS/Windows — x64 or arm64

License

MIT