# itsaplan: Self-Hosted Issue Tracking with Mastra AI Agents

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/croffasia-itsaplan
Generated for open source discovery and AI-assisted research.

It's a Plan is a self-hosted project management and issue tracking app where AI agents work alongside people on shared boards. Built with Mastra, it offers web-based planning plus REST API, webhooks, and MCP access.

GitHub: https://github.com/croffasia/itsaplan
OSRepos URL: https://osrepos.com/repo/croffasia-itsaplan

## Summary

It's a Plan is a self-hosted project management and issue tracking app where AI agents work alongside people on shared boards. Built with Mastra, it offers web-based planning plus REST API, webhooks, and MCP access.

## Topics

- typescript
- self-hosted
- ai-agents
- project-management
- issue-tracker
- kanban
- agentic-ai

## Repository Information

Last analyzed by OSRepos: Mon Oct 26 2026 01:19:32 GMT+0000 (Western European Standard Time)
Detail views: 0
GitHub clicks: 0

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Overview

It's a Plan is a self-hosted project management and issue tracking web app for teams that want people and AI agents to plan and ship work together. Built with Mastra for its AI-agent capabilities, it gives agents project membership, permissions, and issue assignments alongside human teammates. The app also works as a conventional issue tracker if you do not use agents.

It is aimed at teams replacing tools such as Linear, Jira, or Trello while keeping their data and API keys on their own infrastructure. Work can be managed in the web app or accessed through its REST API, webhooks, and MCP server; external coding agents can run through the project's runner package.

## Key Features

- Track projects, issues, cycles, subtasks, custom fields, and links between issues.
- View work as Kanban boards, tables, timelines, or calendars, with configurable filters and grouping.
- Add AI agents as project members, assign them issues, and trigger runs by mention, assignment, or schedule.
- Run internal agents with configured models and tools, or use the runner to delegate work to supported coding CLIs.
- Use a REST API with OpenAPI documentation, an MCP server, and outgoing webhooks.
- Connect pull requests from GitHub, GitLab, Gitea, Forgejo, and Bitbucket to issues.
- Create shared Markdown docs, notes boards, dashboards, and public read-only issue or view links.

## Use Cases

- A software team can plan issues and cycles on shared boards, then assign coding tasks to agents as well as developers.
- A self-hosting team can keep project data and its AI provider credentials on infrastructure it controls, rather than paying per seat.
- A team coordinating marketing, support, or operations can use the same issue tracker, custom fields, dashboards, and calendar views without relying on coding-agent features.
- An organization with its own automation can manage issues through the API or MCP and connect pull request activity through webhooks and forge integrations.

## Our Take

It's a feature-rich, actively changing project for teams that want self-hosted issue tracking and agent participation in the same workflow, but it is still pre-stable.

**Good fit if:**
- You want a self-hosted alternative to Linear-style project management and will benefit from AI agents sharing boards and assignments with people.
- Your team can operate a Docker-based deployment with PostgreSQL and values API, webhook, and MCP access.
- You can work within AGPL-3.0 terms, or evaluate the separate commercial license for your needs.

**Look elsewhere if:**
- You need a stable release with a long operating history; the project is less than six months old and is changing quickly.
- You need a tracker that does not require you to run and maintain your own service and database.
- Your organization cannot accept AGPL-3.0 obligations and does not want to pursue a commercial license.

## Project Health

| Signal | Value |
|---|---|
| Status | **New**: less than six months old and changing fast |
| Last commit | 2026-10-25 (today) |
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 28 (latest v1.8.0, 2026-10-23) |
| Contributors | 43 (top contributor: 58% of commits) |
| Issues closed, last 90 days | 20+ (typically closed in 0 days) |
| Pull requests merged, last 90 days | 91 (typically merged in 0 days) |
| Project age | 3 months |

Checked on 2026-10-26 with the GitHub API.

## Project Facts

- Language: TypeScript
- License: AGPL-3.0
- Stars: 2k
- Forks: 257
- Topics: agentic, agile, ai-agents, bug-reporting, bug-tracker, gantt, issue-tracker, jira
- Website: https://itsaplan.dev/
- Archived: no

## What You Need

Detected in the repository:

- Node.js (from package.json)
- A Compose file to run it with its related services
- A Helm chart for Kubernetes
- Automated checks on GitHub Actions

## Getting Started

For a local trial, the README lists Docker and Bun as requirements:

```bash
git clone https://github.com/croffasia/itsaplan.git
cd itsaplan
bun install
bun run setup
```

Choose “Try it” during setup. See the [README](https://github.com/croffasia/itsaplan) for deployment options and configuration details.

## License in Plain Words

**AGPL-3.0** (network copyleft).

- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the license notice
- Share your changes: yes, the full source, also when people only use it over a network (e.g. as a hosted service)
- Includes an explicit patent grant from the contributors

A summary, not legal advice: the LICENSE file is what applies.

## Alternatives

- [plane](https://osrepos.com/repo/makeplane-plane): Plane is a broader team project management platform for work items, cycles, and modules; itsaplan specifically centers AI agents alongside people on shared boards.
- [kaneo](https://osrepos.com/repo/kaneo-app-app): Kaneo offers board, list, calendar, and Gantt views with task discussions, while itsaplan emphasizes AI-agent collaboration and MCP access.
- [namviek](https://osrepos.com/repo/hudy9x-namviek): Namviek targets small development teams with core self-hosted planning features, while itsaplan is built for people and AI agents to manage work together.

| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| **itsaplan** | TypeScript | AGPL-3.0 | 2k | New |
| [plane](https://osrepos.com/repo/makeplane-plane) | TypeScript | AGPL-3.0 | 60.3k | Active |
| [kaneo](https://osrepos.com/repo/kaneo-app-app) | TypeScript | MIT | 9.4k | Active |
| [namviek](https://osrepos.com/repo/hudy9x-namviek) | TypeScript | GPL-3.0 | 2.6k | Quiet |

## Considerations

The project explicitly warns that breaking changes may occur before its first stable release. Repository activity indicates rapid development, with frequent recent commits and releases; it has contributions from dozens of people and is not identified as dependent mostly on one contributor. Issue and pull request activity is also recent, but that pace can mean operational or upgrade behavior changes quickly.

Production deployment requires a database and container-based setup; the project documents Docker Compose and Helm deployment paths. The README names PostgreSQL as the database and Bun as the runtime for its local trial, while repository metadata also identifies Node.js. The measured requirements do not indicate a test suite. The main project is AGPL-3.0, while `packages/runner` is Apache-2.0, so review the applicable terms before integrating or distributing it.