VibeBusiness

AI-powered autonomous product manager. Research. Build. Ship. Grow — on autopilot.

Install

npm install -g vibebusiness

Requires Node.js 18+.

Quick Start

# Go to your project directory
cd ~/my-project

# Interactive setup wizard (configures AI provider, license, repos)
vibebusiness init

# Preview what the analyst would do (no changes made)
vibebusiness heartbeat --dry-run

# Run a single autonomous heartbeat
vibebusiness heartbeat

# Run continuous session (heartbeats every 5 min for 60 min)
vibebusiness heartbeat --session --duration=60 --interval=5

Commands

| Command | Description | |---------|-------------| | vibebusiness init | Interactive setup wizard | | vibebusiness init --reset | Re-detect repos without re-running full setup | | vibebusiness start | Start local dashboard (default port 3001) | | vibebusiness start --port=4000 | Start dashboard on custom port | | vibebusiness heartbeat | Run autonomous heartbeat cycle | | vibebusiness heartbeat --dry-run | Preview without executing changes | | vibebusiness heartbeat --skip-reasoning | Skip Claude reasoning step (faster) | | vibebusiness heartbeat --session | Run continuous heartbeat session | | vibebusiness heartbeat --session --duration=60 --interval=5 | Run for 60 min, heartbeat every 5 min | | vibebusiness analyze --type=<type> | Run codebase analysis (quick, deep, metrics, seo, research) | | vibebusiness analyze --type=research --topic="..." | Run deep research on a specific topic | | vibebusiness implement --idea=<id> | Implement an approved idea | | vibebusiness status | Show current status and idea counts | | vibebusiness telemetry --enable\|--disable | Manage anonymous telemetry | | vibebusiness version | Show version | | vibebusiness help | Show all available commands |

How It Works

VibeBusiness acts as an AI employee that:

1. Monitors your codebase and KPIs continuously
2. Reasons about what to improve using Claude Code
3. Generates improvement ideas through analysis
4. Implements approved ideas with safe branch-based workflows
5. Learns patterns over time via MEMORY.md

Heartbeat Cycle:
┌─────────────────────────────────────────────┐
│ 1. Load State (ideas, goals, TODO, STATUS)  │
│ 2. Check Alerts (stale KPIs, stuck ideas)   │
│ 3. Fetch Live Data from your APIs           │
│ 4. INVOKE CLAUDE to reason about state      │
│ 5. Execute Claude's recommendations         │
│ 6. Update TODO.md, MEMORY.md, STATUS.md     │
└─────────────────────────────────────────────┘

Features

• Idea Pipeline — Generate, research, approve, implement, ship, and evaluate improvement ideas end-to-end
• Autonomous Implementation — Branch creation, sub-task decomposition, PR creation, auto-merge
• Post-Ship Evaluation — Automatically evaluates shipped ideas against success metrics after 7 days
• Marketing Visuals — Generates 1080×1080 ship announcement cards (PNG) when ideas ship
• Business Intelligence — Competitor research, positioning, growth audits, pricing analysis
• Content Marketing — Keyword research, blog generation, social carousels, email nurture (via ContentFlow)
• Social Media — Twitter/X build-in-public: auto-draft tweets from shipped features, KPI milestones, and weekly digests; review and publish from the dashboard
• Web Dashboard — Kanban board, goals tracking, hypothesis management, session logs

Slash Commands

Available as Claude Code skills when working inside a VibeBusiness project:

| Command | Description | |---------|-------------| | /research-competitors | Discover and research competitors | | /positioning | Generate brand positioning & copy bank | | /build-page | Build landing, pricing, or comparison pages | | /measure-page | Measure live page performance metrics | | /growth-audit | Audit growth channels (SEO, paid, content, referral) | | /pricing-analysis | Competitive pricing analysis | | /validate-idea | Pre-build feasibility research | | /manage | Interactive data editor (query, create, update, delete) | | /social-media | Twitter/X setup, draft generation, status check | | /status-summary | Generate status report |

Analysis Modes

vibebusiness analyze --type=<mode>

| Mode | Description | |------|-------------| | quick | Fast codebase scan for obvious improvements | | deep | Comprehensive multi-repo analysis | | metrics | Performance metrics extraction & anomaly detection | | seo | Technical SEO audit | | research | Deep research on a specific topic (--topic="...") |

Ship Workflow

When an idea is moved to shipped:

1. PR merged to main, idea moved to shipped stage
2. KPI values snapshotted for future evaluation
3. Git metrics tracked (files changed, lines added/removed)
4. Ship announcement card generated (1080×1080 PNG) → data/reports/visuals/
5. Post-ship evaluation scheduled (auto-runs after 7 days)

Social Media (Twitter/X)

Build in public with automated tweet drafts:

1. Connect — Add X API keys to .env, run social-setup-x
2. Draft — Heartbeat auto-generates tweets when you ship features or hit KPI milestones
3. Review — Browse drafts at /social dashboard, edit text, check character count
4. Publish — One-click publish to X, streak tracked automatically

Environment variables (get from https://developer.x.com):

• X_API_KEY / X_API_SECRET — Consumer API key and secret
• X_ACCESS_TOKEN / X_ACCESS_SECRET — User access token and secret

Free tier: 500 posts/month. OAuth 1.0a, text-only (media support planned).

Dashboard

vibebusiness start        # http://localhost:3001

Pages: Kanban board (drag-drop ideas across stages), Goals & KPIs, Hypotheses, Session history, Settings.

Project Files

After running vibebusiness init, these files are created in your project:

data/
├── config.json           # Repository paths and schedules
├── business-context.json # Product info, competitors, constraints
├── ideas.json            # Improvement ideas by stage
├── goals.json            # Business goals with KPIs
├── sessions.json         # Analysis session logs
├── competitors.json      # Competitor research data
├── positioning.json      # Brand positioning & copy bank
├── hypotheses.json       # Growth hypotheses
├── pages.json            # Tracked landing pages
├── social.json           # Social media drafts and metrics
├── implementations.json  # Implementation details per idea
└── reports/
    └── visuals/          # Generated ship announcement cards (PNG)
STATUS.md                 # Current system status (auto-updated)
TODO.md                   # Autonomous task queue
MEMORY.md                 # Learned patterns and context

AI Provider

VibeBusiness uses Claude Code CLI as its primary AI provider (requires Claude Max or Pro subscription).

Fallback: Bring your own API keys:

• ANTHROPIC_API_KEY — Anthropic Claude API
• OPENAI_API_KEY — OpenAI API
• GOOGLE_API_KEY — Google Gemini API

SSH Setup (for autonomous Git operations)

Heartbeat sessions push branches and create PRs autonomously. If your GitHub repo uses SSH, add your key to the agent so git operations don't block on passphrase prompts:

# One-time (persists across reboots on macOS)
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Without this, git fetch/git push will hang waiting for input and eventually timeout.

Cron Setup

# Heartbeat every hour
0 * * * * cd /path/to/project && vibebusiness heartbeat

# Quick analysis daily at 6am
0 6 * * * cd /path/to/project && vibebusiness analyze --type=quick

# Deep analysis Sunday at 3am
0 3 * * 0 cd /path/to/project && vibebusiness analyze --type=deep

License

See LICENSE for details.