Quickstart
From a saved idea to a running agent in three commands.
This walks through the whole flow: connect your machine, pick an idea, and build
it. It assumes you've already generated and saved at least one idea on
hackspot.dev. If you haven't installed the CLI yet, see
Installation — or just use npx as shown below.
Connect this machine
Run login and you'll get a 6-digit code. Enter it on the site while signed in,
and the CLI is handed a token it saves locally.
npx @hackspot/cli login Your code: 7F3K2Q
Open https://hackspot.dev/app/cli and enter it to connect.
(Expires in 10 minutes.)
Waiting for approval...
Connected. You can now run `hackspot build <idea-id>`.Find an idea's id
list prints your saved ideas, newest first, with the id each build takes.
npx @hackspot/cli list 2 ideas:
42 🚀 Pitch Coach (fit 87)
Real-time feedback on your demo delivery
41 🎧 Standup Sync (fit 79)
Async standups that write themselvesThe (fit N) is the idea's fit score for its event. Grab the id you want.
Build it
build scaffolds the project and launches your agent in it.
npx @hackspot/cli build 42 Scaffolded "🚀 Pitch Coach" into /you/pitch-coach
AGENTS.md PROMPT.md hackspot.json
Launching claude in /you/pitch-coach …That's it — your agent is now working from the playbook. See
build for choosing the directory, picking an agent, or
scaffolding without launching.