# Pad

> Project Management for the agent era. Single binary, CLI + web UI, SQLite storage.

Pad is a local-first project management tool. It ships as a single Go binary with an embedded web UI, a CLI, and a `/pad` skill for AI coding agents. No accounts, no cloud required.

## Install

- macOS/Linux: `brew install PerpetualSoftware/tap/pad`
- Docker: `docker run -p 127.0.0.1:7777:7777 -v pad-data:/data ghcr.io/perpetualsoftware/pad`
- Binary: download from https://github.com/PerpetualSoftware/pad/releases
- Source: `git clone https://github.com/PerpetualSoftware/pad && cd pad && make build`

## Quick Start

```bash
cd your-project
pad init
pad agent install    # auto-detects your AI tool and installs the /pad skill
pad item create task "Ship the feature" --priority high
pad server open      # opens web UI in browser
```

## Agent Integration

Pad works with Claude Code, Cursor, Windsurf, Codex, GitHub Copilot, Amazon Q, and JetBrains Junie.

```bash
pad agent install            # auto-detect and install for all tools
pad agent install claude     # Claude Code
pad agent install cursor     # Cursor / Codex / Windsurf
pad agent install copilot    # GitHub Copilot
pad agent install amazon-q   # Amazon Q
pad agent install junie      # JetBrains Junie
```

After installation, use `/pad <anything>` to manage the project through natural language:

```
/pad what should I work on next?
/pad create a task for fixing the auth bug
/pad mark the OAuth fix as done
/pad let's create a plan for v0.2
```

## Docs

- [Getting Started](https://getpad.dev/docs)
- [CLI Reference](https://getpad.dev/docs/cli)
- [Agent Integration](https://getpad.dev/docs/agent-integration)
- [REST API](https://getpad.dev/docs/api)
- [Collections & Schemas](https://getpad.dev/docs/collections)
- [Web UI Guide](https://getpad.dev/docs/web-ui)
- [Configuration](https://getpad.dev/docs/configuration)
- [Self-Hosting](https://getpad.dev/docs/self-hosting)

## Key Concepts

- **Workspaces** — one per project, linked via `.pad.toml`
- **Collections** — typed containers (Tasks, Ideas, Plans, Docs, Conventions, Playbooks)
- **Items** — structured fields + optional rich content (markdown)
- **Conventions** — project rules agents follow automatically (e.g., "run tests before completing tasks")
- **Playbooks** — multi-step workflows for agents (e.g., implementation checklist)
- **Wiki-links** — `[[Item Title]]` links between items

## Source

- [GitHub](https://github.com/PerpetualSoftware/pad)
- License: Apache 2.0