# It's a Plan

> An open-source, self-hosted issue tracker with AI agents built in, letting teams assign issues to people or agents on a shared board with REST API, webhooks, and MCP support.

It's a Plan is an open-source, self-hosted project management and issue tracker licensed under AGPL-3.0 and built by VIBE DEV SPACE LLC. It positions itself as an alternative to Linear, Plane, and Jira, with the distinguishing feature that AI agents participate as real project members — not bolted-on chatbots — sharing the same board, threads, and issue cards as human teammates. The project is under active development, with the repository noting that breaking changes should be expected before the first stable release.

## What It Is

It's a Plan is a self-hosted issue tracker where AI agents hold assignee slots, respond to @mentions in comment threads, and pick up delegated issues just like a human team member would. The entire stack — server, database, and AI model — runs on infrastructure you control. There are no per-seat fees and no vendor lock-in. The REST API, MCP server, and signed webhooks let external scripts, CI pipelines, and other agents drive the same tracker the UI uses.

## How Agents Work as Teammates

Each AI agent in It's a Plan is configured like a new hire: you give it a model (bring your own key), a system prompt, a set of allowed actions, reusable skills, and external tool integrations. Agents are built on the Mastra agent framework. Once set up, an agent can be:

- **Delegated an issue** directly from the board, just like assigning to a person
- **Triggered by @mention** in any comment thread
- **Scheduled** to run on a cron — hourly, daily, weekly, or custom — with a full run history and outcome log
- **Chatted with** directly via a built-in per-agent conversation interface

Agents reply in threads, open linked issues, and move cards on the shared board. Permissions are scoped per agent so each one can only do what you explicitly grant.

## Views, Initiatives, and Dashboards

The tracker offers four layouts over a single dataset — Kanban board, table, timeline, and calendar — with no data duplication when switching. Filters stack on any field (state, priority, assignee, labels, dates), and any combination of filters plus layout can be saved as a named view and shared as a read-only public link without requiring sign-in.

Initiatives group related issues under a strategic goal with an owner, target date, and automatic progress tracking derived from issue states — no manual percentage entry. Dashboards are composable grids of widgets: throughput, cycle time, breakdown by state or assignee, a GitHub-style activity heatmap, agent run health, and webhook delivery outcomes.

## Platform and Integration Architecture

The stack is built on Bun, Elysia (backend), Next.js (frontend with SSR), Drizzle ORM, PostgreSQL, and MinIO for S3-compatible object storage. The full stack runs via a single `docker compose up` command. Key platform capabilities include:

- **REST API** with a full OpenAPI reference and scoped API tokens
- **MCP server** at `/mcp` — any MCP client (Claude, Cursor, custom agents) can call every endpoint as a tool
- **Signed webhooks** with retries and a delivery log
- **Authentication** via email/password, passkey, and Google sign-in
- **Notifications** by email (SMTP or Resend) and Telegram, with per-member preferences
- **Role-based access control** with a full permission matrix per project (read, create, edit, delete per resource)

## Update: v0.5.0

The latest release is v0.5.0, published July 30, 2026. Recent releases in the changelog include:

- **v0.5.0** — Note boards, issue creation improvements, agent enhancements
- **v0.4.0** — Status timeline on every issue, code blocks, slash menu, image support, agent updates
- **v0.3.0** — Per-project section toggles, initiative right-click menu, shareable initiative links
- **v0.2.0** — Public share links, sticky-note boards, file/screenshot support in text, faster initiatives

The project was created in July 2026 and has been shipping releases at a rapid pace, signaling active early development momentum.

## Features
- AI agents as project members with assignee slots
- Kanban board, table, timeline, and calendar views
- Saved and shareable views with stacked filters
- Initiatives with owner, target date, and automatic progress tracking
- Freeform sticky-note canvas (Notes)
- Configurable dashboards with live widgets
- REST API with OpenAPI reference and scoped API tokens
- MCP server exposing every action as a tool
- Signed outgoing webhooks with retries and delivery log
- Scheduled agent runs via cron
- Per-agent model, system prompt, skills, and tools configuration
- Built-in agent chat with conversation history
- Custom fields, labels, states, and issue types per project
- Role-based access control with full permission matrix
- Email/password, passkey, and Google sign-in
- Notifications via email (SMTP or Resend) and Telegram
- Public read-only share links for views and issues
- Bulk edit issues from the board
- GitHub skill import for agents
- Self-hosted on your own server and database

## Integrations
PostgreSQL, MinIO (S3-compatible storage), Docker, Mastra (AI agent framework), OpenAI (and other LLM providers via bring-your-own-key), GitHub (skill import), Telegram (notifications), Resend (email), SMTP (email), Google (sign-in), Claude (MCP client), Cursor (MCP client), Coolify (deployment)

## Platforms
LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
v0.5.0

## Links
- Website: https://itsaplan.dev/
- Documentation: https://github.com/croffasia/itsaplan
- Repository: https://github.com/croffasia/itsaplan
- EveryDev.ai: https://www.everydev.ai/tools/its-a-plan