Are you the author? Sign in to claim
Portuni is a shared map of how your organization works – its processes, projects, areas, and principles – held as one gr
A shared map of how your organization works – its projects, processes, areas, and principles – held as one graph that every tool and every AI agent can read. People and agents draw from the same picture instead of rebuilding context from scratch in every app.
The Portuni server: a TypeScript MCP server (Streamable HTTP) backed by Turso (shared team database) or local SQLite (solo / testing), with a pluggable file-sync layer for files attached to graph nodes.
apps/
server/ MCP/HTTP server: schema, sync engine, tools, auth (Node)
web/ Desktop/web UI (React + Vite)
desktop/ Tauri 2 shell that bundles server + web into Portuni.app (Rust)
sites/
marketing/ Marketing site, portuni.com (Astro)
docs/ Public documentation site, docs.portuni.com (Astro Starlight)
scripts/ write-scope guard, sidecar build, maintenance scripts
test/ node:test suite (no external runner)
docs/ Internal design notes and specs
Requires Node.js 20+ and Varlock.
git clone https://github.com/honzapav/portuni
cd portuni
npm install
npm run build
npx varlock run -- npm run dev
Server listens on http://localhost:4011. Health check: curl http://localhost:4011/health.
The full setup guide – environment variables, Turso vs local SQLite, running multiple instances, connecting MCP clients – lives at docs.portuni.com/getting-started/setup.
Portuni is alpha software in active development. The graph model, MCP tools, events, and file sync are stable enough to build on. Multi-user auth, search, additional file backends, and a proper migration framework are not built yet – manage expectations accordingly.
For the full picture and what's coming next, see Project status & roadmap.
npm test
See CONTRIBUTING.md. Read the docs first – Portuni is built on specific concepts (POPP framework, intentional capture, graph-not-tree) and understanding them helps your contribution fit naturally.
Run Claude Code as an MCP server so any agent can delegate coding tasks to it
@microsoft✓ OfficialBrowser automation using accessibility snapshots instead of screenshots
@googleapis✓ OfficialGoogle's universal MCP server supporting PostgreSQL, MySQL, MongoDB, Redis, and 10+ databases
@github✓ OfficialOfficial GitHub integration for repos, issues, PRs, and CI/CD workflows