BOS-AI: Your AI-Powered Business Operating System

April 18, 2026 · View on GitHub

BOS-AI Banner Agents Status

BOS-AI runs your business. You focus on vision.

Transform your business through the Business Chassis multiplication effect. 30 specialized AI agents handle strategy, marketing, sales, customer service, and finance—so you can focus on what matters.

Quick Start

mkdir ~/my-business && cd ~/my-business && git init
curl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install.sh | bash -s full
claude code .
/coord optimize

That's it. BOS-AI analyzes your business and identifies your biggest opportunity.

Choose Your Path

Running a Business?

You don't need technical skills. BOS-AI helps you with strategy, marketing, sales, and operations.

Start here: Business Operations Guide

Building a Product?

Create your requirements in BOS-AI, then build with AGENT-11.

Start here: Product Developer Guide

NEW: Enhanced PRD Template - Machine-parsable PRDs with System Skeleton (data model, UI sitemap, business rules) for seamless AGENT-11 handoff. See PRD Template.

The Business Chassis

Every business runs on six multipliers:

Profit = Prospects × Lead Conversion × Client Conversion × Average Spend × Transaction Frequency × Margin

The Multiplication Effect:

  • 10% improvement in each = 77% more profit
  • 20% improvement in each = 299% more profit

BOS-AI optimizes all six multipliers systematically.

Learn more: Business Chassis Explained

Essential Commands

CommandWhat It Does
/coord optimizeFind your biggest business opportunity
/coord foundation-quick-startBuild strategic foundation (3-4 hours)
/coord marketing-system-setupCreate complete marketing framework
/coord sales-system-setupCreate complete sales framework
/meeting @agent "topic"Consult with specific specialist
/reportGenerate progress report
/dailyreportTurn progress.md into a daily report plus voice-aligned blog and social posts
/blog <topic>Draft a voice-aligned blog post plus Twitter/X and LinkedIn versions on any topic

/dailyreport and /blog are Claude-native — no API keys, no per-report cost. Both commands share a single voice guide at .claude/data/voice-guide-default.md. Drop a voice-guide.md in your project root to override with your own voice, or set DAILYREPORT_VOICE_GUIDE to point anywhere.

The Four Operations Systems

Build a complete business operating system in 13-17 hours:

SystemTimeWhat You GetCommand
Marketing4-5 hoursBible, Plan, Calendar/coord marketing-system-setup
Sales3-4 hoursBible, Plan/coord sales-system-setup
Customer Service3-4 hoursBible, Plan/coord customer-service-system-setup
Finance3-4 hoursBible, Plan/coord finance-system-setup

Each system multiplies specific Business Chassis components for exponential growth.

30 Specialized Agents

BOS-AI includes 30 business intelligence agents organized by function:

CategoryAgentsFocus
Coordination3Business orchestration, optimization
Discovery3Market research, opportunity validation
Creation3Solution design, value optimization
Delivery3Customer success, quality assurance
Growth3Scaling, market expansion, revenue
Marketing3Brand, campaigns, content
Sales3Pipeline, conversion, revenue ops
Customer Service3Support, satisfaction, retention
Finance3Budget, performance, investment
Legal3Compliance, risk, contracts

Full catalog: Agent Directory

The BOS-AI Lifecycle

┌──────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│   STAGE 1    │    │   STAGE 2    │    │   STAGE 3    │    │   STAGE 4    │
│  Foundation  │───▶│   Creation   │───▶│   Delivery   │───▶│    Growth    │
│              │    │              │    │              │    │              │
│ • Vision     │    │ • Solution   │    │ • Marketing  │    │ • Scale      │
│ • Research   │    │ • Design     │    │ • Sales      │    │ • Expand     │
│ • Strategy   │    │ • Build      │    │ • Service    │    │ • Optimize   │
└──────────────┘    └──────────────┘    └──────────────┘    └──────────────┘
        │                                                           │
        └────────────────── CONTINUOUS IMPROVEMENT ─────────────────┘

Learn more: BOS-AI Lifecycle

BOS-AI vs AGENT-11

BOS-AIAGENT-11
Business operationsSoftware development
30 business agents11 technical agents
Creates PRDs and strategyWrites code and deploys
Defines WHAT to buildImplements HOW to build

They work together but are separate projects.

When you need software built:

  1. Create PRD in BOS-AI
  2. Hand off to AGENT-11 project
  3. Return to BOS-AI for operations

Installation Options

Standard Install

One command — downloads and runs the installer:

curl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install.sh | bash -s full

You'll see progress output as it installs. When it finishes, all 30 agents are ready.

Inspect Before Running (Optional, More Secure)

If you want to review the install script before executing it, do this in three steps:

# 1. Download the script (this command prints nothing — that's normal)
curl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install.sh -o /tmp/bos-ai-install.sh

# 2. Review it (press q to exit the viewer)
less /tmp/bos-ai-install.sh

# 3. Run it
bash /tmp/bos-ai-install.sh full

Pin to a Specific Version

Lock the install to a tagged release:

BOS_AI_VERSION=v1.0.0 curl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install.sh | bash -s full

Set BOS_AI_VERSION to any git tag (e.g. v1.0.0) to install that exact release.

MCP-Enhanced Install

curl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install-with-mcp.sh | bash -s full

Adds direct API connections for 40-60% faster operations. Requires API key configuration.

Troubleshooting: Installation Issues

Security

Report vulnerabilities privately via GitHub Security Advisories.

  • No API keys or secrets in the repo — all credentials load from .env.mcp (gitignored)
  • Install scripts use set -euo pipefail, validate paths, and refuse system directories
  • .env.mcp parsed as key=value pairs, never sourced as shell code
  • Pin installs to a tagged release with BOS_AI_VERSION=v1.0.0
  • Recommended install pattern downloads the script for inspection before running

Documentation

Getting Started

Core Concepts

Reference

Operations

PRD System

Troubleshooting

Quick Reference

Most Common Workflows

Starting a new business:

/coord foundation-quick-start    # 3-4 hours
/coord marketing-system-setup    # 4-5 hours
/coord sales-system-setup        # 3-4 hours

Optimizing existing business:

/coord optimize                  # 15 minutes - find opportunity
/meeting @agent "specific topic" # Deep dive with specialist

Building a product:

/coord solution-design "idea"    # Create PRD
# Then hand off to AGENT-11 project for development

The Formula

Profit = Prospects × Lead Conversion × Client Conversion × Average Spend × Transaction Frequency × Margin

10% improvement in each = 77% more profit

Quick Commands

CommandPurpose
/coord optimizeFind biggest opportunity
/coord dailyDaily business review
/coord weeklyWeekly performance analysis
/meeting @agent "topic"Specialist consultation
/reportProgress report
/pmd "issue"Root cause analysis

Need Help?

Success Path

MilestoneTimeWhat You Achieve
First /coord optimize15 minIdentify biggest opportunity
Foundation documents3-4 hoursStrategic clarity
One operations system3-5 hoursExecution framework
All four systems13-17 hoursComplete business OS
90 daysOngoing77%+ profit potential

Ready to transform your business?

/coord optimize

Business Guide | Developer Guide | Full Documentation