Developer CLI

my-business/
├── pages/                    # CMS pages
│   ├── home.json
│   ├── about.json
│   └── services.json
├── kb/                       # Knowledge base (Markdown)
│   ├── welcome.md
│   ├── services-overview.md
│   └── faq.md
├── services/                 # Service catalog (read-only)
│   └── consultation.json
├── solid.config.json         # Company info + website settings
└── .solid/
    └── manifest.json         # Sync metadata (DO NOT EDIT)

# Create a new client company from a template
solid company create "Mike's Plumbing" --template plumber
# Company created (ID: 47) with plumber template (500+ KB entries)

# Send registration to the client — they get a branded referral email
solid company send-registration mike@mikesplumbing.com --name "Mike"
# Email sent with referral link. Mike onboards + pays on his own time.
# You get referral attribution automatically.

# Keep building while Mike sorts out payment
solid switch "Mike's Plumbing"
solid pull && code .
# Open in VS Code, edit pages/kb, then push

solid switch "Sarah's Salon"
# Switched to Sarah's Salon (ID: 22)

  Solid# CLI Doctor
  ────────────────────────────────────────
  ● PASS  auth          200   489ms  /api/v1/auth/me
  ● PASS  kb            200   487ms  /api/v1/kb/company
  ● PASS  pages         200   497ms  /api/v1/cms/pages
  ● PASS  sites         200   490ms  /api/v1/sites
  ● PASS  services      200   106ms  /api/v1/services/catalog
  ● PASS  orders        200   107ms  /api/v1/orders/
  ● PASS  crm contacts  200   111ms  /api/v1/crm/contacts
  ● PASS  leads         200   108ms  /api/v1/crm/leads/stats
  ● PASS  billing       200    67ms  /api/v1/billing/overview

  ✓ 9 passed  2462ms total

name: Deploy site to Solid#
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20 }
      - run: npm i -g @solidnumber/cli
      - name: Smoke-test backend
        run: solid doctor
      - name: Push changes (dry-run on PR, real on main)
        run: solid push --yes
        env:
          SOLID_API_KEY: ${{ secrets.SOLID_API_KEY }}

~/.solid/
├── config.json           # active company, base URL, token
├── identity.json         # anonymous machine ID for telemetry
└── cli_history.json      # recent commands (for solid feedback context)

solid company create "Mike's Plumbing" --template plumber
# Creating company... done
# Applying plumber template:
#   ✓ 500+ KB entries (services, FAQ, pricing, policies)
#   ✓ Service catalog (leak repair, water heater, drain...)
#   ✓ AI agent training (plumbing terminology, pricing rules)
# Company ready at ID: 47

solid integrations catalog           # Browse available integrations
solid integrations generate          # Scaffold a new integration
solid integrations test <id>         # Run integration tests
solid integrations deploy <id>       # Deploy to production
solid integrations health            # Check all integration health
solid integrations logs <id>         # View integration logs