Get started

Run Minsky against your own repo.

Minsky installs locally and runs against your own git repository. No account, no signup, no hosted service to configure.

1. Install

$ git clone https://github.com/edobry/minsky.git
$ cd minsky
$ bun install
$ bun link

Bun is the recommended runtime. If you'd rather use npm: npm install && npm link works too.

2. Initialize a project

$ minsky init
$ minsky setup

minsky init configures a task backend and git hooks for the current project. minsky setup registers the MCP server for your coding harness and connects a database — on a fresh machine it walks you through a short interactive wizard (a local Docker Postgres, a free-tier Supabase project, or your own connection string). Schema migrations run automatically; there's no separate migrate step.

3. Create and work on a task

$ minsky tasks create --title "Add user authentication"
$ minsky session start --task <id>
$ cd $(minsky session dir <id>)
$ # make changes, then:
$ minsky session pr create --title "feat: Add user authentication"

session start creates an isolated workspace on its own branch. Work happens there; session pr create opens a pull request when you're done.