Skip to main content
Glama
Sign In
portuni

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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
    ResponsivenessNo recent community issues

    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
      C
      maintenance
      MCP server that enables AI coding agents to communicate, share state, and coordinate work in real time via MCP tools or REST API.
      84 npm
      10
      MIT

    • lxDIG MCP

      lexCoder2
      A
      license
      B
      quality
      D
      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
      MIT