Dexio

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.

• Shared context. 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.

• See what they know. 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.

• Safe with many writers. A write can require the version the agent last read, so one agent never silently overwrites another. Every version of every page is kept, so any edit can be undone.

• Plain markdown. Pages are markdown with links between them. Download any wiki as a zip of markdown files whenever you like.

Related MCP server: llm-wiki-kiss

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 (ChatGPT needs a paid plan and its Developer mode); 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 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

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 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.