Documentation

Everything you need to set up and run cursor-automation.com on your own GitHub repos.

• Cursor Automation — Documentation — Welcome to the cursor-automation.com help center. cursor-automation.com is a hosted SaaS that wraps the open-source workflow at [`.cursor/issue-workflow/workflo
• Architecture — cursor-automation.com is a single Phoenix LiveView application backed by SQLite and Oban. All workflow advancement that lives in `.cursor/issue-workflow/workflo
• Authentication — cursor-automation.com uses **GitHub OAuth only**. There are no passwords, no email/password recovery, no magic links.
• Billing — cursor-automation.com is **single-tier, $29 USD per team per month** with a 14-day free trial. No per-seat charges, no per-repo charges.
• Cursor API token — cursor-automation.com uses **your** Cursor Cloud Agents token so that agent usage is billed to you, not to us.
• GitHub App — cursor-automation.com installs as a dedicated GitHub App — **not** an OAuth app. This means you can install it on a per-repository basis and we only see the rep
• Kanban UI guide — The kanban board lives at `/app/repos/:id` and shows nine columns: `Backlog`, the seven `cursor-*` workflow labels, and `Ignored`.
• Email notifications — Every team member can opt in to "email me on every transition". Settings live on the team page. Each (user, team) row has an unsubscribe token; one-click unsubs
• Operator runbook — Configured queues and concurrency are defined in `config/config.exs`: | Queue | Concurrency | Purpose | | ---------
• Security — Sensitive secrets in the database are encrypted with `AES-256-GCM` (via `Plug.Crypto.MessageEncryptor`) using a key derived from the `TOKEN_ENCRYPTION_KEY` envi
• SEO conventions — Marketing pages are server-rendered with semantic HTML and full meta tags.
• Teams, invites, and the public link — Every user gets a personal team on first sign-in (named after their GitHub display name or login). Teams own GitHub installations, repositories, and billing.
• Workflow & label semantics — The workflow follows the open-source spec in [`.cursor/issue-workflow/README.md`](https://github.com/dominicletz/cursor_automation/blob/master/.cursor/issue-wor