---
title: Recipes
description: "Step-by-step examples for common Caged workflows."
---

# Recipes

Practical, copy-paste-ready examples for real-world scenarios. Each recipe is self-contained — pick what matches your use case and adapt it.

<CardGroup cols={2}>
  <Card title="Drive Agents Programmatically" icon="plug" href="/recipes/agent-api">
    Create sandboxes and prompt agents entirely via the API or SDKs — no CLI needed.
  </Card>
  <Card title="Run Claude Code on a Repo" icon="bot" href="/recipes/claude-code">
    Spin up a sandbox, clone your project, and let Claude Code work on it autonomously.
  </Card>
  <Card title="Run Aider on a Repo" icon="code" href="/recipes/aider">
    Pair program with Aider in an isolated sandbox with full git integration.
  </Card>
  <Card title="Run OpenAI Codex CLI" icon="terminal" href="/recipes/codex">
    Use OpenAI's Codex CLI agent in an isolated sandbox environment.
  </Card>
  <Card title="CI Pipeline Agent Testing" icon="settings" href="/recipes/ci-pipeline">
    Run AI agents in sandboxes as part of your GitHub Actions CI/CD pipeline.
  </Card>
  <Card title="Budget-Controlled Batch Jobs" icon="coins" href="/recipes/budget-batch">
    Process multiple tasks with strict cost limits and auto-shutdown.
  </Card>
  <Card title="Snapshot & Restore Workflow" icon="camera" href="/recipes/snapshot-restore">
    Save progress, fork experiments, and restore known-good states.
  </Card>
  <Card title="Multi-Agent Collaboration" icon="users" href="/recipes/multi-agent">
    Run multiple agents working on the same codebase with isolated branches.
  </Card>
  <Card title="Custom MCP Tools" icon="wrench" href="/recipes/custom-mcp-tools">
    Add your own MCP tools to extend agent capabilities inside sandboxes.
  </Card>
  <Card title="Port Forwarding for Web Apps" icon="globe" href="/recipes/port-forwarding">
    Expose dev servers from sandboxes and share preview URLs.
  </Card>
  <Card title="Self-Hosted on Bare Metal" icon="server" href="/recipes/self-hosted">
    Run the full Caged stack on your own hardware with Firecracker VMs.
  </Card>
</CardGroup>