Planwright
Sign in
Quick Start

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 and link a repository

    Inside your workspace, click New Project. Give it a name that matches what you're building, then link one or more GitHub repositories. Planwright associates commits and pull requests with objectives through the linked repos. One repo can serve multiple projects — useful for monorepos and shared services. A GitHub repo is optional — you can create a project with no repo connection and the full objective workflow still applies. See Projects without a GitHub repo in Core Concepts.

  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.

← IntroductionYour First Project →