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:
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:
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://<your domain>, 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:
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.
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 graphsrc/dexio/search.py: word search (MCP tool and the web app's search box)src/dexio/delta.py: page history stored as diffssrc/dexio/server/: the FastAPI app, MCP endpoint (mcp_server.py), storage (db.py, SQLite or Postgres), files (files.py), accounts, OAuth, sharing, billingsrc/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
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.
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 [email protected], 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.