The Welcome guide
Betelgeuse is a block-based notebook. Every page is a plain Markdown file in a git repository on your computer, and AI agents can read and write it through an open MCP server.
The pages inside this one are a guide to everything Betelgeuse can do. Each guide page uses the blocks it describes, so open them, edit them and see what happens. They're ordinary pages, so move them to the Trash when you're done.
This page is the file Welcome.md. The guide pages are its sub-pages, so they live in a Welcome/ folder next to it. See Your files on disk.
Start here
- Type
/on an empty line and pick a block - Select some text and give it a colour
- Press
⌘Kand search for "callout" - Link this page to another one by typing
[[ - Open Roadmap and drag a card on its Board view
- Click the clock in the top bar to see this page's history
- Click Connect agents in the sidebar and connect an AI agent
- Pick a theme and palette in Settings, with
⌘,
The guide
Examples to play with
- Ideas is a scratchpad. Ask an agent to add to it, then check its history.
- Roadmap is a database with table, board and calendar views. Its rows are pages too.