Plot

Ship fast. Write less.

Turn merged product work into an editable, source-cited changelog.

English | 한국어

Current Product

Plot combines six product surfaces:

• Chat — interactive, source-grounded AgentRun work.
• Routines — scheduled or explicitly started AgentRun work.
• Sources — GitHub connections, repository scopes, and writing blocks.
• Artifacts — editable, revisioned, source-cited documents and Markdown export.
• GitHub release automation — release webhooks, trustworthy range detection, and draft generation.
• Billing/entitlement — subscription, trial, plan, and workspace access policy.

The system architecture overview describes the request boundary, execution ownership, persistence conventions, and verification commands. Publishing remains under the user's control outside Plot.

Repository

apps/
web/ Next.js application and same-origin API proxy
api/ Kotlin Spring Boot API and generation worker
packages/
auth/ Better Auth configuration and allowlist policy
api-client/ typed browser client for the Plot API

PostgreSQL is the system of record. Flyway migrations under apps/api/src/main/resources/db/migration are the authoritative schema.

Development

Requirements:

• Java 21
• Bun
• Docker
• just

bun install
just dev-api
just dev-web

Validation:

just lint
just test
just build

API integration tests use PostgreSQL through Testcontainers.

Operations

• GitHub App development smoke test
• GitHub release automation
• Private repository production certification
• Polar subscription webhook