Overview
BaseHalf opens a normal folder as a canvas, keeps the connections between your files as plain text in that folder, and lets your agents read the same structure you see.
BaseHalf is an open-source desktop workspace for thinking with files and agents. It opens a folder you already have as a canvas: the files and subfolders in it become cards you can place, read, edit, and connect.
The connections you draw are saved as plain text in your folder. A note lists what flows into it in an upstream list at its top, so Claude Code, Codex, and any other agent that opens the note sees the same structure you see on the canvas. BaseHalf keeps the list of any other item under .bh/.
Your files stay ordinary files. Git, other editors, and agents keep working on them as before. BaseHalf adds a visual layer and keeps its own files in a hidden .bh/ folder beside your work.
In these docs
Get started
Download BaseHalf, open it the first time, and open a folder as a canvas.
Canvas and cards
How folders become canvases, and how to place, read, edit, select, and arrange cards.
Connections
What an upstream connection means, how to make one, and where it is saved.
Working with agents
Run Claude Code and Codex in the Agent Area, install the BaseHalf skill, and point agents at what you selected.
AI images, video and sound
Generate from a prompt and the cards connected to it, with your own provider keys.
How the pieces fit
- You arrange materials on a canvas and decide what builds on what.
- The files hold the content and the connections, so nothing important lives only inside the app.
- Agents work in the same folder with their own tools. They read the connections from the files, and the BaseHalf skill tells them where the rest is.
BaseHalf does not contain an agent. It is the place where you and your agents look at the same work.
Who it is for
BaseHalf is for anyone whose thinking and an AI's flow on one canvas: someone learning a field, someone making images, video, and sound with AI models, someone who thinks in maps, someone reviewing code. The canvas shows what is there and how it fits together, and agents read the same structure from the files.
What stays yours
What BaseHalf records about your work, such as connections, descriptions, and card places, is in the folder, in plain files. Close the app and the notes, their connections, and their descriptions are still there for git, for other editors, and for any agent. BaseHalf needs no account and no server.