Welcome to Viberia

Viberia is a desktop app that gives you an isometric world map of your software and research projects, where each project is a territory full of buildings that host AI agents you can talk to, queue work for, and coordinate as a team.

What you can do with Viberia

• Run multiple projects in one workspace. Drop a project onto the map, point it at a folder on disk, and stock it with the agents and buildings that fit the work.
• Delegate from a single command surface. A portfolio-level Chief of Staff agent sits above every project; ask it anything and it routes the work to the right Dean, Planner, Developer, or Reviewer.
• Compose workflows out of buildings. Use built-in kinds like CodeForge (Planner + Developer + Reviewer), KnowledgeBase, WorktreeForge, MarketResearchers, and Linear, or build your own with the Building Creation Wizard.
• Use any combination of Claude, Codex, and Gemini. Each agent can run on a different CLI provider, with per-role default models and quick overrides.
• Extend agents with skills and MCP servers. Install slash commands like /draft-a-prd and /implement-the-prd, plug agents into Linear, filesystems, databases, and more.

Quick start

If this is your first time, the fastest path is:

1. Install Viberia — download, point it at your CLI binaries, and grant Full Disk Access on macOS.
2. Run the built-in tutorial — a 14-scene walkthrough creates a sandbox project, drops an HQ, sets up a team, and runs your first real task end to end.
3. Tour the Settings dialog so you know where to find appearance, permissions, skills, and MCP configuration later.

You can re-run the tutorial at any time from Settings → Tutorial.

Supported model providers

Viberia talks to AI models through their official command-line tools. You install the CLI once, point Viberia at it in Settings → CLI Configuration, and every agent that uses that provider picks it up.

Provider	CLI binary	Where to configure
Anthropic Claude	claude	Claude integration
OpenAI Codex	codex	Codex integration
Google Gemini	gemini	Gemini integration

You don’t have to install all three. One is enough to get started, and you can mix providers across agents — for example, a Planner on Claude Opus and a Reviewer on Codex.

The shape of a Viberia session

Once you’re past the loading screen, the app opens to the World View — a single isometric canvas where every project you’ve created lives as a labeled territory. From there:

• The HudShelf along the bottom holds the New Project button, Settings, the Toolbox menu, a queue strip, and the loop tracker.
• The Chief of Staff drawer tab sits on the right edge — pull it out to chat with the portfolio coordinator.
• The Activity Bar (also on the right) lists projects, buildings, agents, and recent notifications.
• The MiniMap, Token Tracker, and Zoom Controls anchor the corners.

If any of these terms are unfamiliar, the Concepts section is the gentlest entry point. If you’d rather poke around first, jump into the tutorial and read the concept pages afterward — the app teaches itself well.

Where to go next

Pick the path that matches what you want to do.

I want to install and get running. Start with Installation & Setup, then Your First Project.

I want to understand the mental model first. Read World, Projects & Territories, then Buildings & Agents, then Chief of Staff & Deans.

I’m shopping for what Viberia can do. Skim the Features section. The capability catalog covers every panel, drawer, and shortcut.

I want to plug Viberia into my existing tools. The Integrations section covers Claude, Codex, Gemini, and Linear.

Something is broken. Jump to Troubleshooting.

How a typical session looks

Most Viberia sessions follow the same shape, even if the work changes.

1. Open the app. You land on the world map. Every project you’ve ever created is still there, in its own territory.
2. Pick what to work on. Either zoom into a project on the map, or pull out the Chief of Staff drawer and describe what you want done — the CoS will route to the right Dean.
3. Send the request. You can talk to a single agent directly or fan a task out to a whole team. Buildings like CodeForge ship with a ready-made Planner / Developer / Reviewer flow.
4. Watch and intervene. Streaming responses, tool call cards, and permission prompts surface as the work happens. You can pause, redirect, or queue more work for any agent.
5. Pick up artifacts on disk. Every project optionally points at a folder on your machine. Files agents create or edit appear there immediately — you can open them in your normal editor or use Viberia’s built-in Toolbox.

Community and feedback

Viberia is in active development and we want to hear what works and what doesn’t.

• In-app feedback — open the HudShelf and click Feedback. Messages are sent to our team channel directly from the app.
• Tutorial replay — if something seems off, re-running the tutorial from Settings → Tutorial is often the fastest way to see whether the issue is in your setup or the product.
• Privacy — anonymized telemetry and crash reporting are opt-in. You can review and toggle every category in Settings → Privacy & Analytics.

When you’re ready, head over to Installation & Setup and let’s get the app running.