Hione
hione is an all-in-one AI tools desktop app + CLI system. The Tauri desktop app provides a graphical interface for managing agents, MCP servers, skills, and settings. The hi command is the CLI tool for launching multi-window AI collaboration in your terminal.
Ask AI about Hione
Powered by Claude Β· Grounded in docs
I know everything about Hione. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
hione β All In One AI Tools
hione is an all-in-one AI tools desktop app + CLI system. The Tauri desktop app provides a graphical interface for managing agents, MCP servers, skills, and settings. The hi command is the CLI tool for launching multi-window AI collaboration in your terminal.
Supported Tools
| Tool | Install | Uninstall |
|---|---|---|
| Claude Code | npm install -g @anthropic-ai/claude-code | npm uninstall -g @anthropic-ai/claude-code |
| Gemini CLI | npm install -g @google/gemini-cli | npm uninstall -g @google/gemini-cli |
| OpenCode | npm install -g opencode-ai | npm uninstall -g opencode-ai |
| Codex CLI | npm install -g @openai/codex | npm uninstall -g @openai/codex |
| Qwen Code | npm install -g @qwen-code/qwen-code | npm uninstall -g @qwen-code/qwen-code |
| Any custom tool | Pass the binary name directly | β |
How It Works
hione operates in two modes:
- tmux mode (CLI default):
hi startsplits your current tmux session into panes β one per AI agent β and launches each tool automatically. - Desktop mode (Tauri): Each agent runs in a separate native window with an embedded XTerm.js terminal. This mode provides a richer UI for managing tasks and configurations.
Features
- Multi-Window Parallelism:
hi start claude,opencode,geminilaunches multiple AI terminals at once - Task Dispatching:
hi push <target> "<task>"routes tasks to specific agents - Structured Result Detection: Reads each tool's native history storage β no fragile text scraping
- Auto-Pull on Stuck: Falls back to terminal snapshot capture for unknown tools after 30s
- tmux Layout: Splits your session into a smart grid (even = equal halves, odd = right-weighted)
- SQLite Persistence: All messages, snapshots, and task queues are stored for traceability
- Auto & Resume Modes:
-askips all permission prompts;-rrestores last session context
Prerequisites
Runtime (always required)
tmux β used for the terminal layout when Tauri desktop is not available:
# macOS
brew install tmux
# Ubuntu / Debian
sudo apt install tmux
# Fedora
sudo dnf install tmux
Windows β tmux does not run natively on Windows. Use one of:
- WSL2 (recommended): Install WSL2, then inside the WSL terminal run
sudo apt install tmuxand usehifrom there. - Git Bash / Scoop: Limited support, not recommended for multi-window features.
AI tools β install whichever agents you want to use (see table above).
For end users β no Rust needed
Download a pre-built release from the Releases page and run the installer.
For building from source
| Dependency | Version | Purpose |
|---|---|---|
| Rust + Cargo | 1.80+ | Compile all crates |
| Node.js | 20+ | Frontend build (Tauri desktop only) |
# Install Rust (macOS / Linux)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Install Node.js (via fnm)
curl -fsSL https://fnm.vercel.app/install | bash
fnm install 20 && fnm use 20
On Windows:
# Install Rust
winget install Rustlang.Rustup
# Install Node.js
winget install OpenJS.NodeJS.LTS
# Restart PowerShell after installation, then verify:
rustc --version
cargo --version
node --version
Installation
Option A β Pre-built Binary
Go to Releases and download:
| Platform | File |
|---|---|
| macOS | hi_macos.dmg or hi.app.zip |
| Windows | hi_windows_setup.exe |
| Linux | hi_linux.AppImage or .deb |
Option B β Build from source (CLI + Desktop)
Using install script (recommended)
git clone https://github.com/your-org/hi.git
cd hione
# macOS / Linux
bash scripts/install.sh --with-desktop
export PATH="$HOME/.local/bin:$PATH"
# Windows (PowerShell)
pwsh scripts/install.ps1 -WithDesktop
The --with-desktop flag will build the Tauri application and install it alongside the hi CLI.
Manual build
git clone https://github.com/your-org/hi.git
cd hione
# 1. Install tauri-cli (required for cargo tauri build)
cargo install tauri-cli --locked
# 2. Install frontend dependencies (first time only)
cd crates/hi-tauri && npm install && cd ../..
# 3. Build desktop app (beforeBuildCommand handles CLI + frontend)
cargo tauri build
Windows PowerShell:
git clone https://github.com/your-org/hi.git
cd hione
# 1. Install tauri-cli
cargo install tauri-cli --locked
# 2. Install frontend dependencies
cd crates\hi-tauri; npm install; cd ..\..
# 3. Build desktop app
cargo tauri build
Desktop Application Usage
Once installed, you can launch the hione desktop app from your Applications folder (macOS), Start Menu (Windows), or via the command line:
# Launch the desktop UI
hi-tauri
In the desktop app, you can:
- Configure Agents: Set up paths and flags for each AI tool.
- Session Launcher: Select tools and project directories to start a new collaborative session.
- Task Panel: Monitor task queues and results across all active agents.
- Skill Manager: Manage custom skills and MCP servers.
Quick Start (CLI)
Prerequisite: CLI terminal mode requires running inside a tmux session. If you haven't installed the desktop app (hi-tauri), first enter tmux:
# Create a tmux session (required for terminal mode)
tmux new -s hi
# Then start three AI agents in separate windows
hi start claude,opencode,gemini
# Auto mode β skip all permission prompts
hi start -a claude,opencode,gemini
# Resume last session context
hi start -r claude,opencode,gemini
# Dispatch a task
hi push opencode "implement JWT auth"
# Check agent status
hi check opencode
# Pull current terminal content
hi pull opencode
CLI Reference
| Command | Alias | Description |
|---|---|---|
hi start [-a] [-r] <tools> | hi s | Start a session |
hi push <target> "<task>" | hi p | Dispatch a task |
hi pull <target> [-t N] | hi pl | Pull window content (default timeout: 5s) |
hi check <target> [-t N] | hi ck | Check if agent is online (default timeout: 3s) |
hi result <id> "<content>" | hi r | Return a task result |
hi esc <id> | hi e | Cancel a task |
Start flags
| Flag | Description |
|---|---|
-a, --auto | Skip all permission confirmations in the launched tool |
-r, --resume | Resume the most recent session context |
Per-tool flags used internally:
| Tool | --auto flag | --resume flag |
|---|---|---|
| claude | --dangerously-skip-permissions | --continue |
| gemini | --yolo | --resume latest |
| opencode | (none) | --continue |
| qwen | --yolo | --continue |
| codex | --full-auto | codex resume --last |
Multi-Agent Collaboration
Custom Tools
Any tool not listed above can be configured in .hione/tools.toml:
[tools.ccg]
auto_flags = ["--dangerously-skip-permissions"]
resume_flags = ["--continue"]
Unknown tools without config are passed through unchanged.
Task Protocol
When an agent completes a task pushed via hi push, it should end its reply with:
Task DONE: <uuid>
Hi detects completion automatically via each tool's structured history storage (JSONL / SQLite). The Task DONE line is required only when Claude coordinates other agents inside a session.
Architecture
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β hi push opencode "Implement login API" β
ββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββ
β Unix Socket (.hione/hi.sock)
βΌ
ββββββββββββββββββ poll every 10s
β hi-monitor β βββββββββββββββββββββββ
β (daemon) β β
ββββββββββ¬ββββββββ βΌ
β Task Queue ββββββββββββββββ
β β hi-tauri β
βΌ β + XTerm.js β
ββββββββββββββββββ β + PTY β
β SQLite (.hione)ββββββSnapshotsββββ€ β
β messages/ β ββββββββ¬ββββββββ
β snapshots/ β β
β task_queue β βΌ
ββββββββββββββββββ βββββββββββββββββββ
β claude / gemini β
β opencode / ... β
βββββββββββββββββββ
Contributing
Please read CLAUDE.md for contribution guidelines before submitting a PR.
License
Distributed under the MIT License. See LICENSE for details.
