Getting Started

Quick Start

Five steps from zero to your first objective on the board and a coding agent ready to pick it up.

1. 1

   Sign up with GitHub

   Go to planwright.tools and click Sign in with GitHub. Planwright uses GitHub OAuth — no email or password. Login does not grant Planwright access to your repositories or code; it only reads your public profile to establish your identity. The first time you sign in, you'll be prompted to install the Planwright GitHub App on your organization so Planwright can listen for webhooks and read repository metadata. See our privacy policy for full details on how we use GitHub.

2. 2

   Your workspace is ready

   Planwright creates one workspace per GitHub organization. If you belong to multiple orgs, pick the one you want to start with. Your teammates sign in the same way — no invite emails, no seat provisioning. Anyone in the org who signs in becomes a workspace member.

3. 3

   Create a project — with or without a repo

   Inside your workspace, click New Project. Engineering teams link a GitHub repository — Planwright associates commits and pull requests with objectives through it, and one repo can serve multiple projects for monorepos. GTM, product, ops, and compliance teams create a project without a repo connection. The full objective lifecycle, agents, and audit chain work identically in both cases. See Beyond Engineering for non-engineering use cases and example objectives.

4. 4

   Write your first objective

   Click New Objective on the board. Write an outcome, not a task. Good: “Add GitHub OAuth login so new users can sign in without a password.” Not: “Implement OAuth.” The objective should be specific enough that a coding agent can start without asking a clarifying question. Add acceptance criteria to make the definition of done explicit.

5. 5

   Connect a coding agent

   Head to AI & Agents and pick your agent — Claude Code, Cursor, Codex, or Amp. Each guide takes under two minutes. Once connected, your agent can see scheduled objectives, claim work, and check in progress — all without leaving the terminal.