Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/flancian/garden/llms.txt

Use this file to discover all available pages before exploring further.

The Agora does not host your data. Instead, it pulls notes from a location you control — typically a public git repository — and renders them alongside contributions from other users, interlinking everything into a shared knowledge graph. To join, you publish your garden yourself and then tell the Agora where to find it.

​
What you need before you start

A GitHub or GitLab account

Most contributors host their garden at github.com or gitlab.com.

Git installed locally

Install from git-scm.com/download. Git comes pre-installed on Linux and macOS.

Notes in Markdown with wikilinks

The default Agora format is Markdown plus [[wikilinks]]. Other formats may be supported — reach out if you use something different.

A public repository

Your notes must be publicly accessible so the Agora server can pull them.
If you do not yet have notes or a digital garden, see Choose an editor for your digital garden first.

​
How to join

1

Publish your digital garden to a public git repository

Push your Markdown notes to a public repository on GitHub or GitLab. The repository can have any name. Every Markdown file whose filename matches a topic becomes a node in the Agora.
git init my-garden
cd my-garden
git add .
git commit -m "initial commit"
git remote add origin https://github.com/your-username/my-garden.git
git push -u origin main
2

Choose a signup method

You have two options: submitting a pull request to gardens.yaml, or sending an email.Option A — Pull request (recommended if you know git):Fork the Agora repository at github.com/flancian/agora, add an entry for your garden to gardens.yaml, and open a pull request. Your entry should include:
  • The URL of your repository
  • Your desired username
  • Confirmation that you agree to the Agora’s contract (as defined by the @agora system account)
Option B — Email:Send the following information to signup@anagora.org:
  • The URL of your repository or content
  • Your desired username
  • Confirmation that you agree to the Agora’s contract
3

Wait for your garden to be integrated

An Agora maintainer will review your submission and pull your garden into the graph. Once integrated, your notes will appear as sources on any node whose name matches one of your filenames.
4

Verify your nodes appear

Navigate to https://anagora.org/<your-username> and to a node matching one of your note titles to confirm your content is live.

​
Your data stays under your control

The Agora never stores your notes on its own servers. It reads from the public URL you provide and re-renders the content. You can update, remove, or move your garden at any time — the Agora reflects whatever is in your repository at its next sync.

​
Supported formats

The primary format is Markdown with wikilinks, which lets you also publish your garden independently as a blog or website using tools like Jekyll, Gatsby, or Nikola. Other note formats are being added over time.
Emacs Org-mode files are supported. Reach out to signup@anagora.org for details on the current state of integration.
Roam exports via the roam2agora tool. Contact the maintainers if you use Roam.
The Agora aims to be maximally inclusive. If you use a different notes system, email signup@anagora.org to discuss support. Non-git sources and additional formats are planned for future releases.

​
Contributing from social media

If you do not want to maintain a git repository, the Agora bridge project aims to let contributors participate via social media accounts. Follow the Agora bots to contribute from Mastodon or Twitter while support matures:
Even a minimal public repository with a handful of Markdown files is enough to join. You can grow your garden over time, and the Agora will pick up new notes on each sync.

Build docs developers (and LLMs) love

Get started for freeTalk to us