Get started

Install the CLI & skill

Turn any project's docs into Bookie bets — from your terminal or straight from Claude Code. Takes about a minute.

Prerequisites

• bun — install from bun.sh
• A Bookie account — create one if you don't have it yet.

1 · Install

From the root of the project you want to track, run:

curl -fsSL https://bookie.hasslebad.com/install.sh | sh

This drops two project-local files:

• .bookie/bookie.ts — the CLI (gitignored; fetched, not committed)
• .claude/skills/bookie/SKILL.md — the Claude Code skill (committed, so your team shares it)

2 · Log in

Authenticate once — your token is stored globally in ~/.config/bookie, so it works across every project:

bun .bookie/bookie.ts login --url https://bookie.hasslebad.com \
  --email you@example.com --password '<password>'

Confirm it worked:

bun .bookie/bookie.ts whoami

3 · Use it

In Claude Code — run the skill:

/bookie

…or just ask "turn this project's docs into Bookie bets." It reads your README/PRD, drafts bets → experiments → tasks, confirms the outline with you, then imports them into your workspace.

From the CLI directly:

bun .bookie/bookie.ts projects          # list orgs + projects
bun .bookie/bookie.ts project <id>      # view a project's bet tree
bun .bookie/bookie.ts import bets.json  # import a project

Add --json to any command for machine-readable output.

Updating & uninstalling

• Re-run the installer to update the CLI and skill to the latest version.
• bun .bookie/bookie.ts logout clears your stored credentials.
• Delete .bookie/ and .claude/skills/bookie/ to remove it entirely.