Introduction

The hackspot CLI turns a hackspot.dev idea into a real project and hands it to your AI coding agent. The website already generated the build playbook — pitch, why it wins, scoped MVP, demo script. The CLI fetches that playbook by id, scaffolds the files an agent reads, and launches the agent on the build.

What it is (and isn't)

It does three things:

1. Connects this machine to your account with a 6-digit device code.
2. Lists the ideas you've saved on the site, with the id each build takes.
3. Builds an idea — scaffolds AGENTS.md, PROMPT.md, and hackspot.json into a directory, then launches your agent there.

The mental model

hackspot.dev idea  ──fetch──▶  scaffolded project  ──launch──▶  your AI agent
   (playbook)                  AGENTS.md / PROMPT.md            (claude / codex / …)
                               hackspot.json

You generate and refine ideas on the website. The CLI is the bridge that gets a chosen idea onto your disk and into an agent's hands in one command.

Start here