bsmnt

bsmnt is a CLI for scaffolding basement projects, adding integrations, and installing optional hooks and agent setup.

Overview

• Scaffold new projects from basement starter templates
• Add Sanity to an existing project
• Copy optional hooks into an existing codebase
• Set up supported agent tooling
• Install the review kit: review skills, agent instructions, and repo PR files

Templates

| Template | Includes | | --- | --- | | Default | Next.js, React, TypeScript, Tailwind, Biome, and Zustand | | WebGPU | Default stack plus React Three Fiber, Three.js, and 3D/WebGPU-ready setup | | Experiment | Default stack plus creative coding utilities and navigation UI |

Live templates

Scaffolded from main and redeployed on every merge, with the Studio at /studio:

• Page Builder: https://bsmnt-pagebuilder.vercel.app
• Page Builder (Cache Components): https://bsmnt-pagebuilder-cache.vercel.app

PRs that change a template get a preview link per affected template automatically. preview:* labels add templates or options, preview:skip turns previews off.

Install

Run without installing:

npx bsmnt
bunx bsmnt

Install globally:

npm install -g bsmnt

Usage

Create a new project:

bsmnt
npx bsmnt
bunx bsmnt

Add Sanity to an existing project:

bsmnt integrate --sanity
npx bsmnt integrate --sanity
bunx bsmnt integrate --sanity

Add hooks to an existing project:

bsmnt add
npx bsmnt add
bunx bsmnt add

Install the review kit on this machine, and in the repo you are in:

bsmnt install review
npx bsmnt install review
bunx bsmnt install review

Update an installed review kit to the latest release:

bsmnt update review

Skip prompts with flags:

bsmnt create my-app --webgpu --sanity --gsap --claude --no-hooks

Command Summary

bsmnt
bsmnt create [project-name]
bsmnt integrate --sanity
bsmnt add
bsmnt install review
bsmnt update review
bsmnt --help

Options

Global

| Option | Description | | --- | --- | | -h, --help | Show help | | -V, --version | Show the CLI version |

create

| Option | Description | | --- | --- | | -d, --default | Use the default template | | --webgpu | Use the WebGPU template | | --webgl | Deprecated alias for --webgpu | | --experiment | Use the experiment template | | --sanity | Add Sanity | | --no-cms | Skip CMS setup | | --gsap | Use GSAP | | --motion | Use Motion | | --no-animation | Skip animation setup | | --claude | Set up Claude Code | | --opencode | Set up OpenCode | | --cursor | Set up Cursor | | --codex | Set up Codex | | --gemini | Set up Gemini CLI | | --no-agent | Skip agent setup | | --no-hooks | Skip hook selection |

integrate

| Option | Description | | --- | --- | | --sanity | Add Sanity to the current project |

add

No command-specific flags currently.

install review

Installs the review kit: the pr-risk, visual-proof and review-guidelines skills for every supported agent (machine-wide), the review block in each agent's global instructions, and — inside a git repo — REVIEW.md, the PR template, the AGENTS.md review block, a CLAUDE.md pointer and the repo's own copy of pr-risk and visual-proof (.agents/skills/, linked from .claude/skills/). The repo's copy is the one its fast lane and reviewers check against; the skills and both instruction blocks tell agents to follow it over an older machine-wide copy. The kit is the standard: existing kit files that differ (REVIEW.md, the PR template, the fast-lane guide, the AGENTS.md block) are overwritten and listed, and the old fast-lane workflow and script are removed; only .github/fast-lane.json, the repo's allowlist, is kept. --protect suggests the checks that ran on the repo's last merged PR as the required ones, warns about any name that never ran there (a required check that never reports blocks every merge), and merges with the branch's existing rules (required checks, approvals, restrictions) instead of replacing them.

New projects and repo installs also get a conservative fast-lane allowlist (.github/fast-lane.json) and the .github/FAST_LANE.md setup guide. With the bsmnt-bot GitHub App installed, basement's review agent (an eve app in basementstudio/agents) reviews every PR into the default branch against REVIEW.md and pr-risk, commits fixes for its own findings, re-reviews them over at most three rounds, and merges a clean fast-lane PR itself after checking the allowlist and the required checks. There are no labels to add. The default config permits ordinary internal Markdown notes and enables a risk gate on new installs for other eligible changes: score 49 or lower, lane fast, no designer's eye, and at most 400 changed lines (lockfiles and generated Sanity files excluded); the internal Markdown allowlist has no size cap. Visual changes need a mobile and a desktop screenshot attached and a no-taste-call reason (design-file execution, token-only values, identical-rendering refactors, visual nits on an existing component). Schema changes follow the score. Building a component (a diff that adds a component file) never merges fast; taste calls, auth or secrets, and policy, CI/build/deployment/tool changes still need human review, while a dependency bump, a token retune or a UI copy change now follows the score. The fast lane adds no human approval step and leaves every other PR's review flow as it was.

| Option | Description | | --- | --- | | --repo | Add the review files to the current repo without asking | | --no-repo | Install machine-wide only | | --protect | Set branch protection without asking | | --no-protect | Skip branch protection |

update review

Brings an installed review kit up to date without prompts: the review skills for every supported agent, the review block in each agent's global instructions and, in a repo that already has the kit, its kit files and skill copies. .github/fast-lane.json is kept. The skills ship inside the package, so a bsmnt older than the latest release runs the latest one (npx bsmnt@<latest> update review) instead of reinstalling its own copy. Repos without the kit are left alone; add it with bsmnt install review --repo.

| Option | Description | | --- | --- | | --no-repo | Update this machine only |

Templates

• Default
• WebGPU
• Experiment

Included Features

• Starter templates
• Encrypted env vars by default (dotenvx: committed encrypted .env, bun install restores keys from 1Password, gitleaks pre-commit + CI guards). Opt out with --no-dotenvx.
• Optional Sanity integration
• Optional hooks
• Optional agent setup
• Review kit in every new project: REVIEW.md, a PR template with Summary, Testing, Risk and How to revert, and the review rules in AGENTS.md, plus the machine-wide review skills and global agent instructions

Local Development

bun install
npm link .

License

ISC