The App and local Spaces

Vibecape is a local-first AI document workspace. Documents, project material, and images remain in an ordinary folder you choose, while the editor and Chat work with that local context.

What is a Space?

Each Space maps to a folder on your computer:

my-project/
├── overview.md
├── meeting-notes.md
├── research/
└── .vibecape/

Your content remains in normal files. .vibecape/ stores local runtime data such as indexes, ordering, archived items, and images; you normally do not edit it directly.

Use one Space for each project, research topic, or long-running writing effort. If two bodies of work rarely reference each other, separate them into different Spaces.

Open and switch Spaces

From the Space list or the Space menu above the document tree, you can:

• switch to a recent Space;
• select a local folder with the plus button;
• open the current Space in Finder, VS Code, or a shell;
• create or clone a collaborative Space from a Remote Group.

When Vibecape starts without a previous Space, it stays on the welcome page and does not write tutorial files to your computer.

A good first setup

1. Create an empty folder such as ~/Documents/my-project.
2. Open that folder as a Space in Vibecape.
3. Create an “Overview” document with the goal, current state, and next step.
4. Add relevant material and let Chat help organize it.

Next, complete your first document and Chat workflow.