Getting Started

Project Status

autosolve is in active development. Things work, but APIs may change. See Status & Roadmap.

Prerequisites

bash

git clone https://github.com/thumbrise/autosolve.git
cd autosolve
go mod download
cp config.yml.example config.yml

Edit config.yml — set your token and repos:

yaml

github:
  token: ghp_your_token_here
  repositories:
    - owner: your-org
      name: your-repo

Migrate and start:

bash

go run . migrate up -y
go run . schedule

That's it. The daemon will validate your repos (preflights), then start polling issues on the configured interval.

Using Task

If you have Task installed: task up does migrate + schedule in one command.

Preflights — validates that every configured repo is accessible via GitHub API, upserts repo records into SQLite
Workers — starts polling issues for each repo on the configured interval (default 5s)

If any preflight fails, workers never start. This is by design — see Two-Phase Scheduler.

Command	What it does
`schedule`	Start the daemon
`migrate up [-y]`	Apply migrations
`migrate up:fresh`	Drop everything, re-migrate
`migrate down <N\|*>`	Roll back
`migrate status`	Show migration state
`migrate create <name>`	New migration file
`jobs list`	Show all pending messages in the queue
`jobs show <id>`	Show one message with full payload