bushido-os

<p align="center"> <strong>⛩ B U S H I D O &nbsp; O S ⛩</strong><br> <em>The Enforcement Layer Between Intent and Execution</em> </p>

<p align="center"> <a href="https://www.npmjs.com/package/bushido-os"></a> <a href="LICENSE"></a> <a href="https://nodejs.org"></a> </p>

---

BushidoOS is an AI Product Manager that lives in your terminal. It generates living product specs, audits your codebase for alignment, cascades requirement changes, and keeps every coding agent (Cursor, Copilot, Claude, OpenClaw) on track.

npx bushido-os kickstart "AI savings app for Gen-Z"

AI writes code faster than ever. But faster code that drifts from the spec is faster waste.

• PM writes a spec in Notion → developer builds with Cursor → spec goes stale → code drifts → nobody notices
• 3 developers prompt 3 different agents → 3 divergent interpretations of the same feature
• Client says "add this" → team builds it → client says "that's not what I meant"

BushidoOS breaks this cycle. Your spec is a machine-readable artifact that audits the code in real-time.

# 1. Create a .env.local with your API key
echo "VITE_GEMINI_API_KEY=your_key_here" > .env.local

# 2. Generate a full product spec from an idea
npx bushido-os kickstart "AI savings app for Gen-Z"

# 3. Check project status
npx bushido-os status

# 4. Audit your codebase against the spec
npx bushido-os audit

# 5. Push a requirement change
npx bushido-os change "Add social savings feature"

| Command | Description | |---------|-------------| | bushido status | Project dashboard — spec health, audit scores, artifact inventory | | bushido kickstart <idea> | Full pipeline: Research → Strategy → Adversarial Roast → Spec Bu