xdev-asia/xdev

Local-first project knowledge for humans and AI agents.
Your Markdown files stay the source of truth. xDev indexes them, flags docs that went stale after code changed, exports agent context (AGENTS.md, CLAUDE.md, GEMINI.md, Cursor rules), and serves them over MCP.
> Status: early preview (0.1). Builds are unsigned; expect breaking changes.
## What works today
| Area | What |
| Docs | Open a folder of Markdown, edit with live preview, full-text search, wiki links and backlinks |
| History | Changes against git HEAD, review and commit from the app, per-file history |
| Stale docs | xdev check reports broken links and docs that went stale or were never verified |
| Agent context | xdev export writes AGENTS.md, CLAUDE.md, GEMINI.md and a Cursor rule; xdev mcp serves the docs over MCP stdio |
| Tasks | A coding agent works in its own git worktree; you review the evidence and diff, then approve or discard |
| Accounts | Claude Code accounts and quota on this machine; API keys in the OS keychain; local Ollama models (CLI only: xdev ai models) |
Guides: status and notifications. All guides: docs/guide.
## Install
Download from Releases or xdev.asia:
| OS | Builds |
| Windows | x64 (.exe, .msi), ARM64 (.exe) |
| macOS | Apple silicon, Intel (.dmg) |
| Linux | x64, ARM64 (.AppImage, .deb) |
The xdev CLI ships as a separate archive per target on the same page. Installers are not code-signed yet, so Windows SmartScreen and macOS Gatekeeper will warn. Updates are signed: the app downloads them in the background and installs on the next start.
## Layout
| Path | What |
| crates/ | Rust core: xdev-core, xdev-vault, xdev-store, xdev-git, xdev-export, xdev-mcp, xdev-ai, xdev-agent, xdev-policy, xdev-api, xdev-cli |
| apps/desktop | Tauri 2 + React desktop app |
| app-packs/ | Apps that install into the shell (docs, adr). Deferred: placeholder manifests, no plugin host (ADR 0001) |
| packages/ui | Design tokens and shared components |
| packages/bindings | TypeScript types generated from Rust (cargo test -p xdev-desktop exportbindings) |
| docs/adr/ | Architecture decisions |
| docs/guide/ | User guides |
## Develop
Requirements: Rust (see rust-toolchain.toml), Node 24, pnpm via corepack. On Windows you also need the MSVC C++ build tools.