← All modes

Private preview

Your agent works
by pull request.

Connect a GitHub repository, give Mindful one small approved task, then review its branch, checks, and preview before anything reaches production.

GitHub App ready

Connect your GitHub account

Authorize your GitHub account. If needed, you can choose repository access immediately afterward.

Connect GitHub
How it works

Small changes, visible review.

01

Connect GitHub

Authorize your GitHub account, then choose which repositories Mindful can access.

02

Choose a bounded task

Mindful proposes the smallest useful change and its acceptance check.

03

Review a pull request

Mindful proposes changes on a branch. Review the diff and your project’s CI before merging.

Current capabilityYou choose the repositories

Only repositories approved by both your GitHub account and the Mindful App are available.

Hosted previewSmall changes by pull request

Tasks use prepaid credits and require hosted execution to be configured. Mindful proposes edits; builds, tests, and production deployment remain in your existing workflow.

Deployment setup

Configure one GitHub App.

Enable Request user authorization (OAuth) during installation and set the callback URL to /api/github/callback. Leave webhooks inactive. Grant repository metadata read, contents read/write, and pull requests read/write. Put the values listed in .env.example into the server environment and use an AGENT_SESSION_SECRET of at least 32 characters. Secrets must never use a NEXT_PUBLIC_ name.