Installation

Get the hackspot CLI on your machine, or run it on demand with npx.

The CLI ships as the @hackspot/cli package on npm. Once installed, the command on your PATH is just hackspot.

Requirements

Node.js 18+ — for the global fetch the CLI relies on. Check with node --version.
An AI coding agent on your PATH if you want build to launch one for you: claude, codex, or opencode. This is optional — you can scaffold without launching and run your agent yourself.

Run without installing

The fastest way to start. npx fetches and runs the latest version each time, so there's nothing to keep up to date:

npx @hackspot/cli login
npx @hackspot/cli list
npx @hackspot/cli build 42

Install globally

If you'll use it often, install it once so hackspot is always on your PATH:

npm install -g @hackspot/cli
hackspot login

pnpm add -g @hackspot/cli
hackspot login

bun add -g @hackspot/cli
hackspot login

Upgrade and uninstall

npm install -g @hackspot/cli@latest   # upgrade to the newest version
npm uninstall -g @hackspot/cli        # remove it

Next step

Quickstart

Log in, list your ideas, and build one in three commands.

Introduction

Turn a hackspot.dev idea into a scaffolded project and hand it to your AI coding agent.

Quickstart

From a saved idea to a running agent in three commands.

On this page

Requirements Run without installing Install globally Upgrade and uninstall Next step