Plain markdown in git
No database and no lock-in. Write in Obsidian, a text editor or the browser. History is the repo.
Open source · coming soon
The knowledge vault
your agents live in.
Astronotes is plain markdown in git, with a managed ontology, a living graph and an append-only ledger. You and every agent you use read and write the same files, and the vault stays tidy because the rules ship with it.
- Markdown you own
- AGENTS.md + skills
- ontology.yaml
- Graph & backlinks
- Ledger
- name.astronotes.ai
project · active
Launch plan
type: projectstatus: activeowned_by: [[You]]
- Draft the onboarding skill
- Decide the ontology types
Decision Workspaces live on their own subdomain, each with its own login. [[Multiplayer]]
Ledger · today
- research agentadded 3 citations to Market scan
- youmarked Decide the ontology types done
Local graph
01 · The vault
Obsidian's freedom, Quartz's garden,
and rules an agent can follow.
Every note is a markdown file with typed frontmatter. The site is just a reading of the files: fast, static and yours.
A managed ontology
ontology.yaml names the types (person, project, task, decision, deadline…), their statuses and relations. A validator reports drift.
A living graph
Wikilinks become typed edges. Backlinks, a global and local graph, tags and full-text search are built in, coloured by the ontology.
Rich blocks
To-dos, tables and databases, kanban, callouts, mermaid diagrams, charts from data and embeds. The markdown stays the source.
personorganisationprojectareataskeventdecisiondeadlineresourcenoteledgerhub
02 · Onboard your agent
Point any agent at the repo. It learns the house rules in one read.
The instructions live next to the notes, so Claude, Cursor, Grok Bot or your own agent all work the same way, and nobody writes a README twice.
- Read
AGENTS.mdThe first file an agent opens: where things go, what never to touch, how to behave. - Load
ontology.yamlThe types, statuses and relations every note must follow. - Use the
skills/Setup, migrate from Obsidian or Notion, add a page, a to-do, a citation, a chart, publish. - Write to the ledgerEvery change is a new, signed line. Nothing is quietly edited, so you can see it and put it back.
# one line in your agent's instructions › Read AGENTS.md, then follow skills/setup ✓ read AGENTS.md rules, layout, etiquette ✓ loaded ontology.yaml 12 types · 5 statuses ✓ found 14 skills add-page, add-todo, cite… ✓ validate 0 errors · 0 orphans › Log today's call and the follow-ups + Meetings/Kick-off.md type: event + Tasks/Send the proposal.md type: task · due fri + Ledger/2026-11-13.md signed_by: agent ✓ graph rebuilt · 3 new backlinks
03 · Multiplayer
Your workspace, on its own address.
Every person or team gets name.astronotes.ai: its own login, its own vault, the same ontology and the same graph. Invite people and agents into one workspace, or share a single project space with its own password.
you.astronotes.ai
Personal vault
Your hub, Now page, to-dos, projects and ledger. Private by default, signed in on every device, laid out for your phone.
team.astronotes.ai
Shared workspace
People and agents edit one vault together. Every change lands in the ledger with who made it, human or agent.
project.astronotes.ai
Project spaces
Turn one meeting or project into its own typed, linked space and share it with a password, without exposing the rest of your notes.
You
Team
Agents
name.astronotes.aimarkdown · ontology · graph · ledger
04 · Collective intelligence
Vaults that link across people.
The north star is a commons: public vaults that cite each other, shared skills and templates, topic hubs, and agents that learn from what the community knows, always with a citation back to the source.
- Publish a page, keep the rest private
- Share skills and ontologies like packages
- Every claim traces to a note and a person
05 · Open source
The repo is the product.
Clone it, own it, deploy the static site anywhere. The repository is being tidied for release. Open source, coming soon.
| Astronotes | Typical garden | |
|---|---|---|
| Agent instructions in the repo | ✓ | – |
| Managed ontology + validator | ✓ | – |
| Append-only ledger | ✓ | – |
| Graph, backlinks, search | ✓ | ✓ |
| Shared workspaces | ✓ | – |
astronotes/ ├─ AGENTS.md # read me first, agent ├─ README.md ├─ ontology.yaml # types, statuses, relations ├─ skills/ │ ├─ setup/ │ ├─ migrate-from-obsidian/ │ ├─ migrate-from-notion/ │ ├─ add-page/ add-todo/ │ ├─ add-ledger-entry/ │ ├─ cite/ make-chart/ │ └─ publish/ ├─ vault/ # your markdown │ ├─ Projects/ People/ │ ├─ Ledger/ │ └─ attachments/ └─ site/ # the static reader
Early access
Get a workspace on astronotes.ai.
We're opening workspaces to a small group first, and the repo goes public soon. Drop us a line with what you'd use it for.