QUICK START · 4 STEPS

Get running in minutes.

Install the CLI, create a project, wire a provider, run a pipeline.

BETAStudio is in active beta. Expect bugs and breaking changes.

Step 1 — Install the CLI

Requires Node.js 18+. Installs the global `studio` command.

$ npm install -g @studio-foundation/cli@beta

Step 2 — Create a project

Scaffolds a project with the `software-full` template. The pipeline, contracts, agents and tools are ready to run.

$ studio init --template software-full --name my-builder

Step 3 — Configure a provider

Set your Anthropic API key. Other providers (OpenAI, Mistral) follow the same pattern.

$ studio config set provider anthropic --api-key $ANTHROPIC_API_KEY

Step 4 — Run your first pipeline

Replace the input with your feature description. Studio validates every stage output against its contract.

$ studio run software/feature-builder --input "Add user authentication with email and password"

Expected output shape

output.json (simplified)YAML

{
  "stage": "feature_spec",
  "status": "success",
  "output": {
    "title": "User authentication flow",
    "acceptance_criteria": [
      "Login with email and password",
      "Session persists across page reloads",
      "Logout clears session immediately"
    ],
    "complexity": "medium"
  },
  "tool_calls": 3,
  "attempts": 1
}

Next steps

What's next?

You have a pipeline running. Three directions to take it further.

Customize your pipeline

Edit stages, agents, and contracts in YAML. The template is a starting point, not a constraint.

Pipeline config →

Build a tool plugin

A .tool.yaml file is all you need. Define the command, parameters, and description. No code required.

Tool plugin docs →

Understand the kernel

Seven packages, strict dependency order. The engine knows nothing about your domain — that's the design.

Read INVARIANTS.md →

Need more detail?

docs.studio-foundation.org (coming soon)·GitHub README ↗