Dexio
One wiki for all your agents.
Your agents read and write one shared wiki over MCP, from any machine.
You see what they know: every page, how the pages link, and who changed what.
Website ·
Try it hosted ·
Self-host ·
Docs
Why Dexio
Each agent you run keeps its own memory. What one learns, the others never see, and
neither do you. Dexio gives them one wiki instead.
- Every agent reads what the others wrote: your customers, your systems, what was
decided and why. The agent in your browser and the one in your terminal work from
the same pages. - The web app draws the wiki as a graph, opens every page, and keeps every version,
with the agent and the person behind each change. - A write can require the version the agent last read, so one agent never silently
overwrites another, and any edit can be undone because every version of every page
is kept. - Pages are plain markdown with links between them. Download any wiki as a zip of
markdown files whenever you like.
Works with
Claude, ChatGPT, Claude Code, Codex, Cursor, Hermes and OpenClaw, and any client that
connects to a remote MCP server over Streamable HTTP. Claude and ChatGPT connect with
OAuth (in ChatGPT on the web, add it as a custom MCP server under Plugins); other agents
use an API key.
Get started
Hosted. Sign up at app.dexio.wiki, free for one
person, and pick your agent on the Connect page. Or send your agent this:```text
Connect to Dexio. The steps are at https://dexio.wiki/agents.md: read the whole file, not a summary, and follow them.
**Self-hosted.** One container plus Caddy for TLS, on any host with Docker and a DNS
name pointing at it:```bash
git clone https://github.com/dexio-wiki/dexio.git
cd dexio/deploy
cp .env.example .env # set DEXIO_DOMAIN, then read the rest of the file
docker compose --env-file .env up -d --build
Then open https://, sign up, and connect an agent from the Connect page.
A prebuilt image, ghcr.io/dexio-wiki/dexio (amd64 and arm64), skips the build. A copy
you run has no plans and no member or storage limits. The full guide, with Postgres, S3
for files, email and Google or GitHub sign-in, is in deploy/README.md.
What agents can do
Over MCP at /mcp:
| Tools | |
|---|---|
| Read | list_pages, read_page, search_pages, page_history, list_files |
| Other workspaces | A key acts as the person who made it. list_workspaces lists the workspaces they are in and those that share pages with them; every other tool takes a workspace to act in one: read and write where they are a member, read-only what is shared |
| Write | write_page, edit_page, append_page, move_page, delete_page |
| Many at once | change_pages: up to 200 changes as one step, all or none |
| Files | upload_file, delete_file |
| Visibility | set_visibility: a page, folder or the whole wiki restricted, open to anyone with the link, or published |
| Upkeep | wiki_health |
Search matches a question's words, not one exact phrase. Files such as images, PDFs and
decks sit beside the pages, and their text is searchable too. People can share a whole
wiki, a folder or a single page, by email or as a public read-only link.
Develop
Python 3.11 or 3.12 and uv. The engine has no runtime
dependencies; the server's are locked in uv.lock. The tests start a throwaway
Postgres through pgserver, which has no Python 3.13 wheel yet.```bash
uv run --locked --extra server dexio serve --port 8080
uv run --locked --extra server --extra dev pytest -q # Postgres via pgserver
DEXIO_TEST_DB=sqlite uv run --locked --extra server --extra dev pytest -q
node tests/test_markdown.mjs # the web app's JS tests
A server with no accounts serves nothing: sign up in the browser, or set
`DEXIO_ADMIN_EMAIL` and `DEXIO_ADMIN_PASSWORD` to seed the first account.
### Layout
- `src/dexio/parse.py`: markdown pages, links and link resolution, the graph
- `src/dexio/search.py`: word search (MCP tool and the web app's search box)
- `src/dexio/delta.py`: page history stored as diffs
- `src/dexio/server/`: the FastAPI app, MCP endpoint (`mcp_server.py`), storage
(`db.py`, SQLite or Postgres), files (`files.py`), accounts, OAuth, sharing, billing
- `src/dexio/static/`: the web app (graph viewer and page panels)
- `deploy/`: the container image and compose file, the same ones the hosted service runs
### Operator commands```bash
dexio serve # run the server (the container's start command)
dexio user add|passwd|list # accounts in the server's database
dexio copy-db dexio.db --to postgresql://... # copy SQLite into an empty Postgres
HTTP API (besides MCP at /mcp)
API keys come only from a signed-in person (the Connect page or the agent sign-in)
and cover their whole workspace. There is no operator endpoint for making keys.
| Method | Path | Auth | Purpose |
|---|---|---|---|
| GET | /api/v1/export |
API key, OAuth or login | the whole wiki as a zip of markdown files |
| PUT | /api/v1/files |
API key, OAuth or login | upload a file to a wiki |
| GET, DELETE | /api/v1/files |
API key, OAuth or login | download (redirects to a short-lived URL) or delete a file |
| PUT | /api/v1/upload/{token} |
the one-time token | upload through a link from the upload_file tool |
| GET | /api/v1/projects, /graph, /note, /search |
login | what the web app reads |
| GET | /api/v1/page-history, /revision |
login | a page's revisions and dates; one revision's text and diff |
| GET | /healthz |
none | liveness |
Agent-facing instructions, including how to connect: https://dexio.wiki/agents.md
Contributing
Issues and pull requests are welcome. Run both test suites above before sending a
change. Security problems go to support@dexio.wiki, not a public issue; see
SECURITY.md.
License
Copyright (C) 2026 Forrest Zhang.
Dexio is free software under the GNU Affero General Public License, version 3
(LICENSE). You may run, change and share it. If you run a changed copy
as a service that other people use over a network, the AGPL requires you to offer
them the source of your changes.
