# DynoCap

> Local Linux sandboxes for coding agents and developers on macOS. Copy a project, run code, review the diff, and export a patch with the CLI, SDK, or MCP.

The HTML docs and these Markdown files describe the same pages. Prefer a single page URL when you only need one topic.

## Tutorials

- [Getting Started with DynoCap](https://dynocap.dev/docs/tutorials/getting-started.md): Install DynoCap on Apple Silicon with Homebrew or curl, prepare a project, and run a command in an isolated Linux microVM.
- [End-to-End Agent Task Workflow](https://dynocap.dev/docs/tutorials/agent-task-workflow.md): Learn how to import a repository into an isolated Node 24 sandbox, run coding tasks, preview diffs, and safely export patches.

## How-to guides

- [Manage Dependencies and Caching](https://dynocap.dev/docs/how-to/manage-dependencies-and-caching.md): How to warm a runtime's package cache under filtered network egress and install from it in completely offline sandboxes, for npm, uv and Go modules.
- [Network Isolation and Egress Policy](https://dynocap.dev/docs/how-to/network-isolation-and-egress.md): How to configure network modes in DynoCap, enforce strict egress boundaries, and prevent data exfiltration.
- [Interactive Shells and Terminal Sessions](https://dynocap.dev/docs/how-to/interactive-shells-and-terminal.md): How to open interactive terminals, handle terminal resizing and signals, and run full-screen console programs in DynoCap.
- [Integrate the TypeScript SDK](https://dynocap.dev/docs/how-to/integrate-typescript-sdk.md): How to programmatically start sandboxes, execute commands, preview diffs, and collect results using @dynocap/sdk.
- [Configure the Model Context Protocol (MCP) Server](https://dynocap.dev/docs/how-to/configure-mcp-server.md): How to connect DynoCap's MCP server to Claude Desktop, Cursor, and Cline to empower LLMs with safe, local sandboxes.
- [Troubleshoot with dynocap doctor](https://dynocap.dev/docs/how-to/troubleshoot-with-doctor.md): How to use dynocap doctor to find what is blocking sandboxes, and dynocap doctor --fix to repair it.

## Reference

- [CLI Overview and Standards](https://dynocap.dev/docs/reference/cli/overview.md): Global options, environment variables, exit codes, and signal conventions for the dynocap command-line interface.
- [CLI Command Reference](https://dynocap.dev/docs/reference/cli/commands.md): Comprehensive syntax, parameters, flags, and behaviors for every dynocap command.
- [CLI JSON Schemas](https://dynocap.dev/docs/reference/cli/json-schemas.md): Exact JSON schemas and field definitions for scripting and automated integration with the dynocap CLI.
- [CLI Error Contracts](https://dynocap.dev/docs/reference/cli/errors.md): Structured error reporting format on stderr, error codes, and recovery suggestions.
- [TypeScript SDK API Reference](https://dynocap.dev/docs/reference/sdk-api.md): Complete class, method, and type definitions for @dynocap/sdk.
- [MCP Tools Reference](https://dynocap.dev/docs/reference/mcp-tools.md): Tool definitions, parameter schemas, and security controls for the DynoCap Model Context Protocol server.
- [Guest Wire Protocol Specification](https://dynocap.dev/docs/reference/guest-wire-protocol.md): Binary framing, packet opcodes, big-endian encoding, and stream multiplexing over virtio-vsock.

## Explanation

- [Architecture Overview](https://dynocap.dev/docs/explanation/architecture-overview.md): How the DynoCap CLI, background daemon, Apple Virtualization.framework, and Linux guest agent interact.
- [Security and Isolation Boundary](https://dynocap.dev/docs/explanation/security-and-isolation.md): Why DynoCap uses hypervisor hardware boundaries instead of containers, and how offline-by-default protects against prompt injection.
- [Task Lifecycle and Finite TTL](https://dynocap.dev/docs/explanation/task-lifecycle-and-ttl.md): The architectural philosophy behind finite sandbox lifetimes, non-renewable TTLs, and 7-day result retention.
- [Git Workspaces and Patch Extraction](https://dynocap.dev/docs/explanation/git-workspaces-and-patches.md): How DynoCap imports Git repositories, sanitizes histories and hooks, and extracts clean, verifiable patches.

Full text: https://dynocap.dev/llms-full.txt