Private betaThe Capx developer platform is available to private beta participants. Join the waitlist for access.

Guides

Deploy Your First Company

End-to-end walkthrough: from choosing a template to approving your first agent recommendation. Takes about 10 minutes.

Tip

Make sure you have completed the Quickstart first. You need the CLI installed and authenticated.

Choose a template

Capx ships with templates for common business types. List them with:

List available templates

bash

capx templates list
# TEMPLATE          AGENTS  PLAYBOOKS  EST. COST
# saas-agency       4       12         $150-300/mo
# ecom-ops          3       8          $100-200/mo
# content-studio    3       6          $80-150/mo
# support-team      2       5          $50-100/mo
# dev-team          3       7          $200-400/mo
# local-marketing   3       9          $99-199/mo
# research          3       5          $120-250/mo
# sales-dev         3       6          $150-300/mo

For this guide, we will use the content-studio template. It includes a researcher, writer, and editor with 6 playbooks for content production.

Initialize from the template

bash

capx init my-studio --template=content-studio
cd my-studio

Customize company.yaml

Open company.yaml and adjust to your needs:

company.yaml

yaml

name: my-studio
description: AI content production studio

agents:
  - role: researcher
    adapter: claude
    model: claude-sonnet-4-6
    budget: 150
    heartbeat: "0 9 * * *"

  - role: writer
    adapter: claude
    model: claude-sonnet-4-6
    budget: 200
    heartbeat: "0 10 * * *"

  - role: editor
    adapter: openai
    model: gpt-4o
    budget: 100
    heartbeat: "0 11 * * *"

governance:
  approval_required: true
  auto_approve_below: 5
  spend_cap: 300
  kill_switch: enabled

playbooks:
  - content-pipeline
  - research-brief
  - editorial-review
  - social-repurpose
  - newsletter-draft
  - seo-audit

Add a custom playbook

Create a new playbook for your specific workflow. For example, a weekly industry report:

playbooks/weekly-report.yaml

yaml

playbook: weekly-report
version: 1
trigger: scheduled
schedule: "0 8 * * MON"

inputs:
  industry: { type: string, default: "AI infrastructure" }
  depth: { type: string, default: "comprehensive" }

steps:
  - name: research
    agent: researcher
    tool: web-research
    with:
      query: "${inputs.industry} news this week"
      depth: ${inputs.depth}
    rubric:
      relevance: 0.8
      recency: 0.9

  - name: write
    agent: writer
    tool: content-write
    with:
      research: ${steps.research.output}
      format: "weekly-report"
      length: 1500
    rubric:
      quality: 0.85
      clarity: 0.8

  - name: edit
    agent: editor
    tool: content-review
    with:
      draft: ${steps.write.output}
    approval: required

Add it to your company.yaml playbooks list:

company.yaml

yaml

playbooks:
  - content-pipeline
  - research-brief
  - editorial-review
  - social-repurpose
  - newsletter-draft
  - seo-audit
  - weekly-report    # new

Deploy

Deploy the company

bash

capx deploy
# Deploying my-studio...
# ✓ Runtime provisioned
# ✓ Agents activated (3/3)
# ✓ Playbooks loaded: 7
# ✓ Governance: approval queue enabled
# ✓ Live at my-studio.capx.ai

Trigger a playbook run

Run the weekly-report playbook

bash

capx playbook run weekly-report \
  --input industry="AI infrastructure" \
  --input depth="comprehensive"

# Running weekly-report v1...
# Step 1/3: research (researcher) ✓ 18s, $0.64
# Step 2/3: write (writer) ✓ 12s, $0.52
# Step 3/3: edit (editor) → awaiting approval
#
# Total cost: $1.16
# Run ID: run_8k2m9x

Review agent output

Inspect the run

bash

capx activity --run run_8k2m9x
# STEP      AGENT       TOOL             COST   RUBRIC  STATUS
# research  researcher  web-research     $0.64  0.91    completed
# write     writer      content-write    $0.52  0.87    completed
# edit      editor      content-review   $0.00  -       awaiting approval

View the editor's recommendation:

View the recommendation

bash

capx tasks show run_8k2m9x:edit
# Task: editorial review of weekly report
# Agent: editor
# Status: awaiting approval
# Recommendation: "Minor edits applied. Tightened intro, fixed 2 citations.
#   Suggest adding a section on funding rounds. Overall quality: strong."
# Attachments: weekly-report-v1-edited.md

Approve the recommendation

Approve the task

bash

capx tasks approve run_8k2m9x:edit --feedback "Ship it. Good call on the funding section."
# ✓ Approved. Output committed.
# ✓ Run completed. Total cost: $1.16

Tip

You can also approve from the dashboard at my-studio.capx.ai or via the API: POST /v1/companies/my-studio/tasks/:id/approve.