Skip to main content

Documentation Index

Fetch the complete documentation index at: https://astralform.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Astralform uses auto-capsule — agents with non-system skills automatically get an isolated Capsule sandbox (Firecracker microVM). No manual configuration needed.

​
How It Works

When an agent with skills processes a conversation turn:
  1. A sandbox is provisioned using the agent’s sandbox_template (default: base)
  2. A shared /workspace filesystem is mounted via S3
  3. The agent runs tools (shell, code, files) inside the sandbox
  4. On completion, the sandbox remains active for subsequent turns

​
Agent Configuration

Configure sandbox behavior per agent:
FieldDescriptionDefault
sandbox_templateVM template: base, browser, code-interpreter-v1, desktopbase
sandbox_envsEncrypted environment variables injected into the VM—

​
Session Management

View active sessions, uptime, and command history in the Capsule > Sandboxes dashboard page. Use the MCP tools astralform_list_capsule_sessions and astralform_get_capsule_stats for programmatic access.