Quickstart

Connect DraftStack

Start with the hosted app at https://draftstack-dev.vercel.app, then use the CLI for repeatable setup.

1. Sign in to DraftStack.

draftstack auth login

You should see output like:

Logged in to https://draftstack-dev.vercel.app

2. Install the GitHub App for the owner that contains the docs repository and monitored source repositories.

draftstack setup github --print-url

Open the printed URL, choose the GitHub owner, and grant access to the selected repositories.

3. Create or update the static documentation site and register the DraftStack project.

draftstack sites create \
  --repo draftstack-docs \
  --source-repo pat-baseten/draftstack \
  --force \
  --output json

You should see JSON with the docs repository, generated files, and project details:

{
  "docsRepo": "pat-baseten/draftstack-docs",
  "sourceRepo": "pat-baseten/draftstack",
  "project": {
    "id": "project-id"
  }
}

4. Add the Baseten API key that DraftStack uses for model calls.

draftstack projects api-key set <project-id> --env BASETEN_API_KEY

5. Backfill recent merged pull requests after the GitHub App is installed.

draftstack projects backfill <project-id> --days 7 --output json

6. Review suggestions before any docs pull request is opened.

draftstack suggestions list --project <project-id> --output json