Skip to main content
Glama
honzapav

portuni

by honzapav
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Portuni

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.

What's in this repo

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

Related MCP server: myBrAIn

Quickstart

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.

Project status

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.

Tests

npm test

Contributing

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessResponsive

Resources

Related MCP Connectors

Related MCP Servers

  • Claude Habitat

    Ydy4HYW7ExA
    F
    license
    Not graded
    quality
    Not graded
    maintenance
    An MCP server that provides persistent project context, workflow management, and knowledge capture for AI coding agents. It enables agents to maintain structured memory across sessions by tracking project profiles, conventions, skills, and technical debt.
    7
    -

  • myBrAIn

    lilium360
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that provides persistent memory and contextual awareness to language models, enabling project onboarding, recall of architectural rules, and code consistency across sessions.
    32
    MIT

  • agent-comm

    keshrath
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that enables AI coding agents to communicate, share state, and coordinate work in real time via MCP tools or REST API.
    202 npm
    5
    MIT

  • lxDIG MCP

    lexCoder2
    F
    license
    B
    quality
    B
    maintenance
    MCP server that gives AI coding assistants persistent memory, structural code graph analysis, and safe multi-agent coordination, enabling them to answer architectural questions, track decisions across sessions, and coordinate safely in multi-agent workflows.
    39
    4
    -