World, Projects & Territories

A project in Viberia is a named territory on a single shared world map — a 15×15 tile region that holds your buildings, agents, and (optionally) a folder on your computer.

Why this matters

Most tools give you a flat list: a sidebar of projects, a tab strip of repos, a dropdown of workspaces. That works fine when you have three things. It stops working when you have twelve, each with its own team of agents, its own folder on disk, and its own state of completion.

Viberia replaces that list with a map. Every project you create becomes a piece of land you can see, place buildings on, and walk between. The world is one shared canvas, not a switcher — when you open Viberia, you see all your work at once. Distance is meaningful: you decide where each project sits. Recently active projects glow. Quiet ones sit at the edges.

The reasoning is simple. Software portfolios are not lists; they’re spatial. You remember where things are. A world map gives you a stable mental layout that survives between sessions, so you don’t waste energy hunting for “that prototype from last month.”

The model

Viberia’s world is built from a small number of objects. Here’s how they nest:

Layer	What it is	Persisted as
World	The single isometric canvas you see on first launch. There is one world per Viberia install.	App state
Project (Territory)	A 15×15 grid region with a name, an ID like `p_a1b2c3d4`, and an optional folder on disk.	Row in the local database
Buildings	Squares placed on a territory. Each hosts agents.	Rows under the project
Agents	AI assistants stationed inside buildings.	Rows under their building

The world

There is exactly one world. You don’t switch between worlds; you pan and zoom around inside it. The world has sea (CSS background), land (the playable area), and territories that rise out of the land when you create them. Your MiniMap in the top-right shows the whole world at a glance with a viewport rectangle you can drag.

A project is a territory

When you create a project, Viberia carves out a 15×15 tile region of land and gives it a name. That region is the project’s territory. It has:

A name you chose (renameable from HQ).
A project ID that looks like p_ followed by 8 characters. You’ll rarely see this — Viberia shows the name — but it exists in the database and in some file paths.
An optional folder_path pointing to a directory on your computer.
A label hovering above the land (toggleable in Settings → Appearance).
Buildings and agents that live inside it.

The folder on disk

A project can be linked to a folder on your computer. This is the directory your agents read and write into. If your project is “Acme Website” and you point its folder_path at ~/Workspace/acme-website, then every agent stationed in that project will treat that folder as its working directory.

You don’t have to link a folder. A project without one is fine for planning work or running research that produces artifacts elsewhere. But most software and writing projects do link one, because that’s where the actual files live.

You set the folder when creating the project, or later from HQ → Project Settings.

Persistence

Everything you place on the world — projects, buildings, agents, their settings — is persisted locally. Close Viberia, reopen it, and the world is exactly as you left it: same projects in the same spots, same buildings, same conversation history. No cloud sync, no account. Your portfolio is yours and lives on your machine.

How you interact with it

Creating a project

Click New Project in the HudShelf along the bottom of the screen. You’ll be asked for a name and (optionally) a folder. Viberia picks an empty patch of land, animates the new territory rising into place, and drops an HQ building on it. The project is now active.

If you prefer, you can drag the HQ to a specific tile during placement — that’s where the territory will anchor.

Opening a project

You don’t really “open” a project the way you open a file. Projects are always visible on the world map. To work inside one, you do one of:

Click a building in the territory to open its Building Window.
Double-click the project to deep-zoom into it (camera flies to the territory).
Click the project name in the AB Window on the right edge to focus the camera on it.

Editing project settings

Every project’s HQ building is the settings hub. Click HQ to open it, and you’ll find:

Name — rename the project.
Folder path — link, unlink, or change the disk folder.
Project-wide skills and MCP — extensions available to every agent in the project.
Delete project — at the bottom, with confirmation.

The MiniMap

The MiniMap sits in the top-right corner of the world view. It shows the whole world at a fixed scale with each territory as a colored shape and your current viewport as a rectangle. Drag the rectangle to jump the main camera. Useful when you have more than five or six projects and the world starts to feel big.

The AB Window

The AB Window on the right edge is the parallel text view of the same data. It lists every project, every building inside each project, and every agent inside each building, with notification badges and recent-activity indicators. Click anywhere in the tree to focus that thing on the world map.

Deleting a project

From HQ → Delete Project. You’ll be asked to confirm. Deleting a project removes its territory, buildings, and conversation history from Viberia’s local database. It does not touch the folder on disk — your code, documents, and files are untouched. If you re-link the same folder to a new project later, you’ll start fresh on the Viberia side.

Lifecycle at a glance

Action	Where	What happens
Create	HudShelf → New Project	Territory rises, HQ drops, optional folder linked
Open	Click building, double-click territory, or AB Window	Camera or window focuses on what you clicked
Edit	HQ → Project Settings	Rename, change folder, manage skills/MCP
Delete	HQ → Delete Project	Removes from Viberia; on-disk folder untouched

Buildings & Agents — what lives inside a territory.
Chief of Staff & Deans — who runs the project versus the portfolio.
World Map — pan, zoom, animations, controls.
Activity Bar (AB Window) — the right-edge tree view of your world.
HQ — the per-project settings building.