# Viberia

> A macOS desktop app that lets you orchestrate multiple AI coding agents through a strategy game-style isometric interface, supporting Claude, Codex, and Gemini.

Viberia is a macOS desktop application that turns AI agent management into a visual, game-like experience. Instead of juggling terminal windows, users get an isometric world map where each software or research project occupies its own territory, populated with buildings that host AI agents. The app is currently at v0.5.0, available for Apple Silicon, with Windows and Linux support listed as coming soon.

## What It Is

Viberia is an agent harness — a local-first desktop tool for orchestrating teams of AI coding agents across multiple projects simultaneously. The core metaphor is a strategy game: projects are territories on a map, agents are characters you can click and talk to, and buildings like CodeForge bundle pre-wired Planner/Developer/Reviewer workflows. The FAQ describes it as "the agent management platform that you'll spend 4000+ hours on," positioning it as a long-running workspace rather than a one-shot tool.

## How the Isometric Workflow Works

The app opens to a **World View** — a single isometric canvas showing every project as a labeled territory. From there:

- A **Chief of Staff** agent sits above all projects and routes work to the right Dean, Planner, Developer, or Reviewer.
- **Buildings** like CodeForge, KnowledgeBase, WorktreeForge, and MarketResearchers encapsulate multi-agent workflows; users can also build custom buildings with the Building Creation Wizard.
- The **HudShelf** along the bottom holds the New Project button, Settings, Toolbox, queue strip, and loop tracker.
- Agents stream responses in real time; tool call cards and permission prompts surface as work happens, letting users pause, redirect, or queue more tasks.
- Every project optionally points at a folder on disk, so files agents create or edit appear immediately in the user's normal editor.

## Multi-Provider and Local-First Architecture

Viberia talks to AI models through their official command-line tools — `claude`, `codex`, and `gemini` — which users install separately and point to in Settings. The FAQ and README both emphasize that no LLM content leaves the user's machine; Viberia's own servers are not involved in model calls. Telemetry is opt-in and limited to which windows are opened and which agent kinds are used. The app is described as intentionally lightweight: low-poly art keeps GPU load low, and the FAQ recommends keeping fewer than five agents active at a time to manage memory from CLI processes.

## Agent Hierarchy and Skills

Viberia supports a layered agent hierarchy. A portfolio-level Chief of Staff routes work to project-level Deans, who in turn coordinate Planners, Developers, and Reviewers. Agents can be extended with slash-command skills like `/draft-a-prd` and `/implement-the-prd`, and can be plugged into MCP servers for Linear, filesystems, databases, and more. Each agent can run on a different provider, enabling mixed setups such as a Planner on Claude Opus and a Reviewer on Codex.

## Update: Viberia v0.5.0

The latest release is v0.5.0, published on May 19, 2026, available as a `.dmg` for Apple Silicon (aarch64). The GitHub releases repository was created in March 2026 and last updated in May 2026, indicating active early development. The FAQ notes a pending change to Viberia's Claude CLI pipeline ahead of Anthropic's plan-policy update taking effect June 15, signaling active maintenance. Windows and Linux builds are on the roadmap but not yet available. The FAQ also states the developer intends to open-source Viberia in the future but is holding back due to security and reskinning concerns.

## Features
- Isometric world map UI for managing multiple AI agent projects
- Chief of Staff agent for portfolio-level task routing
- Pre-built building types: CodeForge, KnowledgeBase, WorktreeForge, MarketResearchers
- Building Creation Wizard for custom agent workflows
- Multi-provider support: Claude, Codex, Gemini
- Per-agent model selection and provider mixing
- Agent Loop Scheduling for recurring tasks
- MCP server integration for Linear, filesystems, databases
- Slash-command skills (e.g., /draft-a-prd, /implement-the-prd)
- Git worktree setup without leaving the app
- Local-first: no LLM data leaves the machine
- Streaming responses with tool call cards and permission prompts
- Opt-in anonymized telemetry
- Token Tracker and MiniMap in the UI
- Built-in tutorial with 14-scene walkthrough

## Integrations
Anthropic Claude (claude CLI), OpenAI Codex (codex CLI), Google Gemini (gemini CLI), Linear, MCP servers, Filesystem tools, Databases

## Platforms
WINDOWS, MACOS, LINUX, API, CLI

## Pricing
Open Source

## Version
v0.5.0

## Links
- Website: https://getviberia.com
- Documentation: https://getviberia.com/docs
- Repository: https://github.com/get-viberia/viberia-releases
- EveryDev.ai: https://www.everydev.ai/tools/viberia
