Acta

Boards and docs in one self-hostable server, co-managed by humans and AI agents.

Acta (Latin: "things done") is an open-core, MCP-first project management and documentation product: kanban boards with stable item keys (SW-142) and an enhanced-Markdown wiki, behind one API that treats AI agents as first-class, fully attributed actors.

• MCP from day one: every capability is an MCP tool with the same fidelity as the UI, built for token economy (batch idempotent ops, delta reads, section-level doc patches).

• Humans and agents co-manage: unified actor model, audit trail on every mutation, safe concurrent editing via revision and section-hash guards.

• Docs are Markdown: a precisely specified extension set (callouts, collapsibles, [[cross-references]], live item embeds) over CommonMark + GFM.

• Self-host first: one Docker container, SQLite, runs on NAS-class hardware.

Authentication is passwordless: email one-time codes local to your instance, or standard OpenID Connect against your own provider (Keycloak, Auth0, Okta, Entra, Google Workspace and anything else that speaks it). Members can mint personal access tokens that let an editor, a script or an MCP client act as them, with their role and their name in the audit trail.

Documentation covers self-hosting, authentication, migrating from Trello and Confluence, and connecting an agent over MCP.

Layout

• server/ Hono app on Bun: REST API (/api/v1), MCP endpoint (/mcp), webhooks, rules kernel, serves the built SPA

• web/ Vue 3 SPA built on @nubisco/ui

• shared/ ids, zod schemas, enhanced-Markdown utilities

• importers/ Trello and Confluence import CLIs

• docs/ VitePress documentation

Related MCP server: Tracker MCP Server

Self-hosting

docker compose up -d   # see docker-compose.yml; data lives in the acta-data volume

The server prints one-time login codes to its log until an email sender is configured, which is fine on a laptop and unacceptable once other people use the instance. See Install and Authentication.

Documentation

Full documentation is at docs.nubisco.io/acta:

It is in two halves.

For users, if your team runs an instance: what Acta is, concepts, working in it, and connecting your own agent.

For developers, if you run, integrate with or work on it: install, configuration, authentication, migrating from Trello and Confluence, the MCP endpoint and its tools, architecture and the data model.

Development

pnpm install
pnpm dev            # server + web in parallel
pnpm quality:check  # test + lint + format:check + types:check

@nubisco/ui is consumed from a sibling ../ui checkout via a pnpm link override; CI reproduces the same layout.

Contributing

Contributions are welcome under the Individual CLA; see CONTRIBUTING.md. Generic UI components belong in @nubisco/ui, not here.

Support this project

Acta is free and self-hostable, and stays that way. Building and maintaining it takes real work, so if it saves your team time, sponsorship is what keeps it going.

• ❤️ Sponsor via GitHub

• ⭐ Star the repository, which is how other people find it

• 🐛 Report a bug or send a pull request

If you would rather not run it yourself, or you need something built around it, talk to Nubisco.

More from Nubisco

Acta is built and maintained by Nubisco, a Portuguese software company that builds the tools it needs and opens the ones useful to other people.

License and trademarks

The code in this repository is MIT licensed. Hosted, multi-tenant, and SSO modules are developed separately and are not part of this repository.

"Acta", "Nubisco", and the Nubisco logo are trademarks of Nubisco, Lda. The MIT license does not grant permission to use them; forks and derived products must use their own names and branding.