itsaplan README

项目的 README,来自 github.com/croffasia/itsaplan。合并为一个 markdown 文件:README.md。

It's a Plan — open-source project management and issue tracking where people and AI agents ship together

The open-source Linear alternative
where AI agents take issues like teammates

Use it as a regular issue tracker from day one. When you are ready, give an agent an issue the way you give it to a colleague, and review the result yourself or let another agent check it. Put agents on a schedule, or build a workflow that passes an issue from agent to agent. Self-hosted, on your own server.

#8 Repository of the Day on GitHub Trending #13 TypeScript Repository of the Day on Trendshift

If It's a Plan looks useful to you, star the repo ⭐ and leave a review on Product Hunt.

Deploy on Railway Deploy on Coolify Self-host with Docker Deploy Pro version

Board, timeline, initiatives, cycles, docs, notes, dashboards, AI agents, schedules, and workflows

Why It's a Plan

Community features

Area What you get
Product management Kanban, table, timeline, and calendar views · cycles · custom fields · dashboards · docs · notes boards · project templates · import from Linear, Trello, and Plane
AI agents Agents as project members · internal on any model, or external on your coding CLI · runs start on an @mention, an assignment, or a schedule
Platform REST API with OpenAPI · MCP server · webhooks · pull requests from 5 forges · SSO over OIDC and SCIM · passkeys and Google sign-in
13 languages English · Українська · Русский · 简体中文 · 繁體中文 · العربية · Français · فارسی · Português (Brasil) · Bahasa Indonesia · Español · 한국어 · Türkçe
Product management: the full list
  • Configure issues per project: custom fields, labels, states, and issue types
  • Kanban, table, timeline, and calendar views. Save a view as a tab with its own filters, fields, and two-level grouping, for the whole project or only for you. Each person orders and hides their own tabs
  • Cycles that time-box the work. Unfinished issues move to the next cycle
  • Subtasks, checklists, attachments, and links between issues: blocks, relates, duplicates
  • Comment threads with replies, and @mentions of people and agents
  • Project dashboards: throughput, burnup with a projected completion date, breakdown, and pulse
  • Quick actions on an issue, and automatic assignment when an issue moves to a state
  • Docs: Markdown pages in a tree, with revision history, private and locked pages, embedded files, comments, @mentions, and links to issues
  • Notes boards: sticky notes on a canvas, with colors, checklists, and connections
  • Share a view, an issue, or a document by public link, read-only and without sign-in
  • Initiatives that group and track related work inside a project
  • Project templates: save a project as a template for your team, or publish it to the gallery at itsaplan.dev
  • Import projects from Linear, Trello, and Plane
  • Auto-archive, a notification inbox, and role-based access control
AI agents: the full list
  • Agents as project members, with their own permissions and assigned issues
  • Internal agents run on the instance. Configure the model, system prompt, tools, and reusable skills, written inline or imported from a GitHub repository
  • External agents run on your machine, under your own account. @itsaplan/runner gives each task to Claude Code, Codex, Antigravity CLI, GitHub Copilot CLI, opencode, Pi, Oh My Pi, Mastra Code, or any command that reads stdin
  • Your own code can also take tasks from the run queue through the API
  • A run starts on an @mention in a comment on an issue or a document, on an assignment, or on a schedule. A schedule starts on a timer or when an issue moves to a state
  • Tokens and cost of every run, by agent, project, and model
  • Tools for other services: Notion, Telegram, Threads, Instagram, Jina, Firecrawl, Keenable, DataForSEO, Gitea, Forgejo, and GitHub
  • Images, video, music, and speech from the models on Kie: Nano Banana, Seedream, Kling, Veo, Suno, and others, with one API key
  • Chat with each agent, with its own history. Turn chat off for an agent that only works on mentions, assignments, and schedules
  • Chat with an external agent too. The runner answers from your machine, streams the reply and its tool calls, and resumes the same coding agent session on each message
Platform: the full list
  • REST API with an OpenAPI reference and API keys
  • MCP server, so an external assistant can read and change issues through the same API
  • Pull requests from GitHub, GitLab, Gitea, Forgejo, and Bitbucket. "Fixes KEY-42" links the pull request to the issue, and the issue moves when the pull request opens and merges
  • Outgoing webhooks for the events you pick, with signed payloads, retries, and a delivery log
  • Sign-in with an email or username and a password, a passkey, Google, or your identity provider over OIDC. SCIM keeps accounts in sync with your directory
  • Notifications by email (SMTP, Resend, or Microsoft 365) and Telegram, with preferences for each member
  • Instance administration: storage limits, the mail provider, and instance-wide settings

Pro edition

It's a Plan Pro: run your issue tracker up to 91% cheaper than Linear, Jira, Asana and Plane. $240 a year for the whole instance, any number of people.

Bring the whole team. Pro adds full control over workspaces, agents and spend.

[!TIP] $240 a year for the whole instance, 1 person or 500. Fast Deploy installs Pro on your own server in about 5 minutes.

Everything in Community, plus:

See what each feature does →

Three ways to run Pro:

On Railway and by hand, enter the key in god mode under License. Without a valid key, Pro runs as Community. Your data stays when you switch editions.

Get more with Pro: $24 a month or $240 a year

Getting started

Deploy on Railway

The whole stack in one click, with no server to maintain. You give Railway two hostnames, and it generates every secret. You need a domain of your own: the guide explains why, and what to do after the deploy.

Fast Deploy for Pro

With a Pro license, Fast Deploy installs Pro on a new server in your Hetzner, Vultr or DigitalOcean account. See Pro edition.

Try it on your machine

Requirements: Docker and Bun.

git clone https://github.com/croffasia/itsaplan.git
cd itsaplan
bun install
bun run setup   # answer "Try it"

It picks free ports, generates the secrets, starts the whole stack in Docker, and opens http://localhost:3001. Everything runs on localhost, so no domain and no reverse proxy are needed. Run it again later to restart the instance; the data stays.

Everything else

Built with

Layer Technology
Runtime Bun + Turborepo
Backend Elysia
Frontend Next.js App Router, SSR
UI shadcn/ui + Tailwind v4
Auth better-auth
Database Drizzle + PostgreSQL
Storage S3-compatible object store (RustFS)
AI agents Mastra

Contributing

Issues and pull requests are welcome — bug fixes, features, docs, all of it. Start with CONTRIBUTING.md. It covers the setup, the conventions, and how a change gets merged. Be kind; we follow a Code of Conduct.

Thank you to everyone who has contributed to It's a Plan:

Contributors

Not ready to contribute code? Star the repo and share it — it is the simplest way to help the project grow.

Security

Found a vulnerability? Report it privately through GitHub Security Advisories, not a public issue, so we can fix it first. Details in SECURITY.md.

License

Copyright © 2026 Andrii Poluosmak.

AGPL-3.0, except packages/runner, which is Apache-2.0.

A commercial licence is available if AGPL-3.0 does not fit your company. Ask on Telegram.

itsaplan (croffasia/itsaplan)

正在搜索数据库…

这是什么?Plan 是一个开源、可自托管的项目管理和问题追踪工具,是 Linear、Jira、Trello 和 Plane 的替代品。这里的 AI 智能体会与真人一起工作,作为真正的团队成员,拥有角色并被分配问题。
这只是又一个问题追踪工具吗,还是因为有 AI 智能体而有所不同?它本身就是一个完整的问题追踪工具,支持项目、看板、迭代周期、自定义字段和仪表盘。此外,智能体还会获得角色、权限和负责人席位,并与你的团队成员在同一个看板上接手问题。
我该怎么把它跑起来?最简单的方式是点击 Deploy on Railway 一键部署到 Railway(需要你自己的域名)。如果想在本地使用,请安装 Docker 和 Bun,然后运行安装脚本。脚本会自动选择空闲端口、生成密钥,并通过 Docker 在 localhost 上启动整个服务栈。
我需要 Docker 吗,还是可以不用容器运行?本地试用需要 Docker 和 Bun。它也支持完整的自托管指南、Coolify,以及适用于任何 Kubernetes 集群的 Helm Chart。
现在它够稳定,可以放心用吗?还不够。项目仍在积极开发中,README 明确提醒,在第一个稳定版本发布之前,可能会出现不兼容的变更。
我的项目数据和 AI 智能体的活动到底存放在哪里?所有内容都运行在你自己的服务器和数据库上,并使用你自己的 API 密钥。没有按席位收费,也没有供应商锁定;本地试用模式则完全在 localhost 上运行。
AI 智能体在这里到底怎么执行任务?一次运行可以由 @提及、任务分配或定时计划触发。内部智能体在实例上运行,可配置模型和技能;外部智能体则通过 @itsaplan/runner 包在你自己的机器上运行,驱动 Claude Code、Codex、Antigravity CLI、GitHub Copilot CLI 或 opencode 等工具。
底层用的是什么技术栈?运行时使用 Bun 和 Turborepo,后端是 Elysia,前端是 Next.js App Router,搭配 shadcn/ui 和 Tailwind v4。认证使用 better-auth,数据库使用 Drizzle 加 PostgreSQL,AI 智能体使用 Mastra。
界面支持哪些语言?英语、乌克兰语、俄语、简体中文、阿拉伯语、波斯语、法语、葡萄牙语(巴西)、印度尼西亚语、西班牙语和韩语。
作者
croffasia
大小
18.6 MB
星标
2.4K
时长
4个月
提交 · 90 天