Astronotes
Waitlist

Open source · git-backed markdown

One memory for all your agents.

Astronotes is a vault in git that Claude, Cursor, Grok Bot, and you all read and write. Notes stay markdown. The ontology keeps the names honest. The ledger remembers what changed.

Join the waitlist View the repo

Repo going public soon

Page

How a vault stays honest

ontology ledger skill

Agents and people share one set of files. A type lives in the frontmatter. A tag takes its colour from ontology.yaml. A change is a new line in the ledger, not a quiet edit.

The open-source vault

Built for agents, readable by you.

  1. 01

    Three panes, and a graph

    Explorer, note, and the local graph, in the Quartz shape. The global graph colours notes by the ontology: type, tag, or folder.

  2. 02

    A managed ontology

    ontology.yaml names the types, the relations, and the tag colours. Typed frontmatter is the contract. astronotes validate reports what drifted.

  3. 03

    A ledger you can revert

    Days append. Corrections are new lines. You can see what an agent changed, and put it back, because the history is the file.

  4. 04

    Blocks for the real work

    Kanban, tables and databases, maps, embeds, callouts, mermaid, and charts. The markdown stays the source. The page is just a reading of it.

  5. 05

    Skills included

    Point Claude, Cursor, Grok Bot, or any other agent at AGENTS.md and the skill for the job. They share the rules, and the same files.

  6. 06

    A fast static build

    One command writes a site you can deploy anywhere. No account, no database, no second copy of the vault.

How it works

Clone it. Aim your agents. Publish.

  1. Clone

    The repo is the product. Markdown, skills, and the compiler that publishes them.

  2. Point your agents

    Tell each agent to read AGENTS.md, then the skill for the task. They write the same vault you do.

  3. Build and deploy

    Validate, build, and put the static site wherever you already host files.

git clone https://github.com/placeholder/astronotes
cd astronotes
npm install
npx astronotes validate
npx astronotes build

Open source

The vault is yours.

Star it, read it, run it. The repository is not public yet.

Repo going public soon

Star on GitHub View the repo

Hosted Astronotes

Share anything.

Every published page has a clean link people and agents can pass around: astronotes.ai/you/the-page. You set who can open it, per page or for a whole folder. Folders pass that choice down. The default is private.

Hosted Astronotes

Coming soon.

A hosted vault for people who want the same files and the same agents, without running the build. Publish a page and hand someone astronotes.ai/you/the-page. Leave it private, or open it to the link, or to everyone. No account yet. Leave an email and, if you like, what you would use it for.