Nyxdoc

A new document system for the agent era.

한국어 · 日本語

Nyxdoc is a document system where people and their external agents read and write the same documents, then continue from one shared revision history.

You keep talking to the agent you already use—Codex, Claude Code, OpenClaw, or another MCP client. The agent connects to Nyxdoc through MCP/API. Nyxdoc itself does not put a chatbot between you and your documents.

See Nyxdoc

These are real screens from a clean Ubuntu installation, not design mockups.

People can queue document work for their external agents, attach context and completion criteria, and review the returned result in the same workspace.

Related MCP server: agenthold

Why Nyxdoc

Most document tools were designed around people typing every change. Nyxdoc starts from a different expectation:

• agents will do much of the routine reading and writing;

• people will guide, review, and occasionally edit directly;

• every human and agent change must remain understandable to the next actor; and

• documents need a stable API, identity, permission, and revision model—not only a visual editor.

Git repositories are excellent for source code. Nyxdoc gives ordinary documents a focused editor, document tree, shared drafts, explicit revisions, agent identities, scoped keys, assignments, and a protocol designed for document work.

Highlights

• Notion-familiar rich editor with headings, lists, tables, code blocks, internal/external links, clipboard image upload, shortcuts, and Yjs drafts

• explicit canonical revisions created only by Save / Ctrl or ⌘ + S / agent commit

• document-as-folder tree, resizable navigation, saved views, backlinks, PDF output, Markdown and Nyxdoc bundle export

• global agent identities and credentials reusable across workspaces

• optional organizations with owner/admin/member roles, one-time invitations, flat teams, explicit person/team workspace access, organization-owned agents, and approved personal-agent BYOA

• workspace-specific RBAC, document-tree scope, credential caps, expiry, IP/CIDR restrictions, audit records, and human approval boundaries

• Agent To-do: a person queues document work and an assigned external agent can claim, report progress, submit a result revision, and return it for review

• Streamable HTTP MCP and versioned REST APIs with capability discovery, structured search, batch reads, safe patching, idempotency, diffs, restore, presence, change feeds, and short-lived direct binary image uploads that never put base64 in a document

• 30-day trash and verified backup-before-purge flows for documents, workspaces, and agent identities

• English, Korean, and Japanese interfaces, with per-account locale preferences

• no telemetry

Quick start with Docker Compose

The supported self-hosting path is Linux, Docker Engine, and Docker Compose v2. The lifecycle scripts are Bash/Linux scripts: macOS and Windows Docker Desktop are useful for local development, but are not supported targets for install, update, uninstall, backup recovery, or production operation. Use a Linux host or VM for those commands. Node.js 24 is used for local development.

See the open-source newcomer guide for prerequisites and the five-minute path.

For a local trial, clone and install in one command:

git clone https://github.com/getnyxdoc/nyxdoc.git && cd nyxdoc && ./scripts/install.sh

The installer creates .env.production, generates two different secrets without displaying them, pulls the versioned release image matching this checkout, starts every service, and waits for health checks. To build this checkout instead, use ./scripts/install.sh --build.

Open http://localhost:3191. The first account becomes the site owner. SMTP and a custom email domain are optional. Registration is invitation-only after the first owner by default.

Update, stop, or remove the trial with explicit lifecycle commands:

./scripts/update.sh
./scripts/uninstall.sh
./scripts/uninstall.sh --purge --confirm-purge=nyxdoc

For the one-time update from 0.25.17 or 0.25.18, run the current release bridge from the Nyxdoc checkout instead:

curl -fsSL https://raw.githubusercontent.com/getnyxdoc/nyxdoc/v0.25.19/scripts/update-bootstrap.sh | bash

The bridge closes the public collaboration boundary and drains already accepted editor writes before the legacy updater creates its backup. From 0.25.19 onward, use ./scripts/update.sh normally.

update.sh requires a clean Git checkout and creates a verified pre-update backup before changing a running installation. A failed matching update can resume only from its persisted, re-verified backup receipt. Normal uninstall preserves documents, media, backups, configuration, and the source checkout. Purge removes the Docker data volume and locally built images, but still preserves the external backup directory, configuration, and source. For HTTPS, backups, updates, removal, and recovery, read DEPLOYMENT.md.

Local development

npm ci
cp .env.example .env.local
npm run dev

The app runs at http://localhost:3100; the collaboration service runs at 127.0.0.1:3101.

Quality checks:

npm run typecheck
npm run lint
npm test
npm run test:editor-e2e
npm run build

Connect an external agent

After signing in, open Settings → Workspace → Agent access → Connect the first agent. Choose or create an agent identity, access profile, document scope, and connection key. A new key is shown only once; the UI-generated private handoff contains the workspace-default MCP URL, Streamable HTTP transport, Bearer authentication, and verification steps.

Call get_capabilities first, then list_agent_workspaces. For the complete five-minute path, Codex/Codex CLI setup, OAuth, image uploads, and Agent To-do boundaries, see docs/open-source-readiness.md, docs/agent-contract.md, and docs/mcp/oauth.md.

Project status

Version 0.25.21 is an early 0.x release used with real documents. Data migrations are forward-only and rehearsed against verified backups, but APIs and UI details may still evolve before 1.0.

Personal use remains the default. Organizations are optional ownership and administration boundaries; organization membership alone never grants document access, which is assigned explicitly per person or team at each workspace.

Documentation

• Product vision

• Architecture

• Workspace model

• Organization and team model

• Document model

• Agent protocol

• MCP client compatibility

• MCP OAuth

• Conversation handoff

• Agent To-do

• Editor quality gate

• Open-source newcomer guide

• Testing and release qualification

Community and security

Issues and pull requests are welcome. Read CONTRIBUTING.md and CODE_OF_CONDUCT.md. Report vulnerabilities privately as described in SECURITY.md.

Nyxdoc is maintained on a best-effort basis without an SLA. Support requests and issue-triage boundaries are described in SUPPORT.md.

License and brand

Nyxdoc is free and open-source software under the MIT License, copyright © 2026 Seungji Lee. Anyone may use, modify, redistribute, sublicense, or sell it, including as part of a paid product or hosted or managed service, subject to retaining the MIT copyright and permission notice. No separate commercial license, fee, royalty, or revenue share is required.

The Nyxdoc name and logo are not granted by the code license. Modified products should use a distinct name and logo; factual wording such as “based on Nyxdoc” is welcome. See TRADEMARKS.md.

See LICENSING.md for a plain-language licensing guide.

Acknowledgements

Nyxdoc was created by Seungji Lee with OpenAI Codex as a development collaborator, including work with GPT-5.6 Sol. Nyxdoc is an independent, vendor-neutral project and is not sponsored or endorsed by OpenAI.