# Project pack: Plane @ d9726d5

Facts about **Plane** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Plane is an open-source project tracker, a Jira and Linear alternative. You break work into issues, group them into cycles (sprints) and modules, and view them as lists, boards, calendars or timelines. It also has pages for notes and a public API, and you can run it yourself or use the hosted version.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Verdict source: https://developers.plane.so
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/makeplane/plane
- Pinned commit: `d9726d5c9615756135f3d6cd512ece8e2dd42902`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/makeplane/plane/archive/d9726d5c9615756135f3d6cd512ece8e2dd42902.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://developers.plane.so
- Licence: **AGPL-3.0-only**. Free to use and change. If other people use your changed version, including over a network (for example a website you host for them), you must offer them your source code under the same licence. Using it privately for yourself or your household has no extra obligations.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/makeplane/plane bespoke-plane
  cd bespoke-plane
  git checkout --detach d9726d5c9615756135f3d6cd512ece8e2dd42902
  # Prepare development requirements and local configuration first.
  corepack enable
  pnpm install
  ./setup.sh
  docker compose -f docker-compose-local.yml up -d
  pnpm dev
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  curl -fsSL -o setup.sh https://github.com/makeplane/plane/releases/latest/download/setup.sh
  chmod +x setup.sh
  ./setup.sh
  # choose 1 (Install), then 2 (Start), and open http://localhost
  ```
- Tools these commands use: Docker with 4 GB or more of memory; Node 22 and pnpm plus Python 3.12 for development
- Develop: `pnpm dev`
- Test: `pnpm check`
- Check/lint: `pnpm check:lint`
- Build: `pnpm build`
- Stack: typescript, python (React, Next.js, Django, Django REST Framework, Celery, Turborepo, pnpm). Difficulty for a non-developer with an AI: **advanced**. A large monorepo with several web apps, a Django API and background workers. Workspace settings, labels and views need no code. New features touch the web app and API together.
- The project's own AI instructions, in the repository: `AGENTS.md`.
Personal data: **yes**. Stored in: Postgres database plus an uploads store (Docker volumes). Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/plane/d9726d5/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/plane/d9726d5/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/plane/d9726d5/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/plane/d9726d5/r3/SKILL.md)