# Islo

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.islo.dev/_mcp/server

## Docs

- [Islo Overview](https://docs.islo.dev/overview.md): Zero-setup sandbox environments, accessible from anywhere. Your environment follows you - laptop, server, or browser.
- [Installation](https://docs.islo.dev/getting-started/installation.md): Install Islo CLI on macOS or Linux using the one-liner script.
- [Quick Start](https://docs.islo.dev/getting-started/quick-start.md): Get up and running with Islo in 5 minutes. Install, authenticate, create a sandbox, and run your first command.
- [Automations](https://docs.islo.dev/concepts/automations.md): factory lines orchestrate multi-stage work. Jobs run in sandboxes. Triggers, schedules, and run control live on the line.
- [Sandbox Lifecycle](https://docs.islo.dev/concepts/sandbox-lifecycle.md): Automatic pause, resume, and deletion policies for sandboxes.
- [Setup Scripts](https://docs.islo.dev/concepts/setup-scripts.md): How Islo runs your setup commands after creating a sandbox.
- [Gateway Inference](https://docs.islo.dev/concepts/gateway-inference.md): Use Islo-managed models through OpenAI-compatible and Anthropic-compatible SDKs.
- [Incoming Webhooks](https://docs.islo.dev/concepts/incoming-webhooks.md): Receive external events, route them to sandboxes, and run lifecycle actions automatically.
- [AWS](https://docs.islo.dev/integrations/aws.md): Give an Islo sandbox access to your AWS account by registering an IAM role for it to assume.
- [Harbor](https://docs.islo.dev/integrations/harbor.md): Run Harbor agent evaluations and RL rollouts on Islo environments — with built-in anti-cheating egress control and $250 in free credits for every Harbor user.
- [CLI Overview](https://docs.islo.dev/cli/overview.md): Complete reference for all Islo CLI commands. Authentication, sandbox management, configuration, and project setup.
- [Authentication Commands](https://docs.islo.dev/cli/authentication.md): Islo authentication commands for login and logout using OAuth 2.0 with PKCE, plus API key support.
- [API Keys](https://docs.islo.dev/cli/api-keys.md): Create and manage Islo API keys for CI, scripts, and other non-interactive use.
- [Project Setup](https://docs.islo.dev/cli/project-setup.md): Initialize and configure a project for Islo with islo init and islo add.
- [Sandbox Commands](https://docs.islo.dev/cli/sandbox-commands.md): Islo CLI commands for creating, managing, and executing code in secure sandbox environments.
- [Agent Integration](https://docs.islo.dev/cli/agent-integration.md): Run AI coding agents in Islo sandboxes with islo use --agent.
- [Snapshots](https://docs.islo.dev/cli/snapshots.md): Save and restore sandbox state with Islo snapshots.
- [Gateways](https://docs.islo.dev/cli/gateways.md): Configure network policies and credential injection with Islo gateways.
- [Sharing](https://docs.islo.dev/cli/sharing.md): Share sandbox ports with teammates or the public using islo share.
- [Utilities](https://docs.islo.dev/cli/utilities.md): CLI commands for diagnostics, organization switching, updates, shell completions, and machine-readable schemas.
- [islo.yaml Configuration](https://docs.islo.dev/cli/islo-yaml.md): Complete reference for the islo.yaml project configuration file schema.
- [Troubleshooting](https://docs.islo.dev/cli/troubleshooting.md): Common problems when running the Islo CLI and how to fix them.
- [Changelog](https://docs.islo.dev/changelog/llms.txt)

## API Docs

- API Reference > tenants [List allowed compute regions](https://docs.islo.dev/api-reference/tenants/list-tenant-compute-regions.md)
- API Reference > knowledge [List Knowledge](https://docs.islo.dev/api-reference/knowledge/list-knowledge.md)
- API Reference > knowledge [Create Knowledge](https://docs.islo.dev/api-reference/knowledge/create-knowledge.md)
- API Reference > knowledge [List Tags](https://docs.islo.dev/api-reference/knowledge/list-knowledge-tags.md)
- API Reference > knowledge [Create Knowledge Media](https://docs.islo.dev/api-reference/knowledge/create-knowledge-media.md)
- API Reference > knowledge [Get Knowledge](https://docs.islo.dev/api-reference/knowledge/get-knowledge.md)
- API Reference > knowledge [Delete Knowledge](https://docs.islo.dev/api-reference/knowledge/delete-knowledge.md)
- API Reference > knowledge [Update Knowledge](https://docs.islo.dev/api-reference/knowledge/update-knowledge.md)
- API Reference > knowledge [Get Content](https://docs.islo.dev/api-reference/knowledge/get-knowledge-content.md)
- API Reference > knowledge [Put Content](https://docs.islo.dev/api-reference/knowledge/put-knowledge-content.md)
- API Reference > knowledge [List Versions](https://docs.islo.dev/api-reference/knowledge/list-knowledge-versions.md)
- API Reference > knowledge [Get Version](https://docs.islo.dev/api-reference/knowledge/get-knowledge-version.md)
- API Reference > knowledge [Get Version Content](https://docs.islo.dev/api-reference/knowledge/get-knowledge-version-content.md)
- API Reference > knowledge [Restore Version](https://docs.islo.dev/api-reference/knowledge/restore-knowledge-version.md)
- API Reference > credits [Get the credit balance for the current tenant](https://docs.islo.dev/api-reference/credits/get-credit-balance.md)
- API Reference > integrations [List integration providers](https://docs.islo.dev/api-reference/integrations/list-integration-providers.md)
- API Reference > integrations [List provider-native integration triggers](https://docs.islo.dev/api-reference/integrations/list-integration-triggers.md)
- API Reference > integrations [Get one provider-native integration trigger](https://docs.islo.dev/api-reference/integrations/get-integration-trigger.md)
- API Reference > integrations [List User Integrations](https://docs.islo.dev/api-reference/integrations/list-integrations.md)
- API Reference > integrations [List Custom Services Endpoint](https://docs.islo.dev/api-reference/integrations/list-custom-services.md)
- API Reference > integrations [Create Custom Service Endpoint](https://docs.islo.dev/api-reference/integrations/create-custom-service.md)
- API Reference > integrations [Disconnect Custom Integration](https://docs.islo.dev/api-reference/integrations/disconnect-custom-integration.md)
- API Reference > integrations [Get Integration Status](https://docs.islo.dev/api-reference/integrations/get-integration-status.md)
- API Reference > integrations [Disconnect Integration](https://docs.islo.dev/api-reference/integrations/disconnect-integration.md)
- API Reference > integrations [List provider-native integration triggers with tenant connection status](https://docs.islo.dev/api-reference/integrations/list-connected-integration-triggers.md)
- API Reference > gateway-profiles [List gateway profiles](https://docs.islo.dev/api-reference/gateway-profiles/list-gateway-profiles.md)
- API Reference > gateway-profiles [Create gateway profile](https://docs.islo.dev/api-reference/gateway-profiles/create-gateway-profile.md)
- API Reference > gateway-profiles [Get gateway profile with rules](https://docs.islo.dev/api-reference/gateway-profiles/get-gateway-profile.md)
- API Reference > gateway-profiles [Delete gateway profile](https://docs.islo.dev/api-reference/gateway-profiles/delete-gateway-profile.md)
- API Reference > gateway-profiles [Update gateway profile](https://docs.islo.dev/api-reference/gateway-profiles/update-gateway-profile.md)
- API Reference > gateway-profiles [Add rule to profile](https://docs.islo.dev/api-reference/gateway-profiles/create-gateway-rule.md)
- API Reference > gateway-profiles [Remove rule from profile](https://docs.islo.dev/api-reference/gateway-profiles/delete-gateway-rule.md)
- API Reference > gateway-profiles [Update rule](https://docs.islo.dev/api-reference/gateway-profiles/update-gateway-rule.md)
- API Reference > gateway-profiles [Batch update rule priorities](https://docs.islo.dev/api-reference/gateway-profiles/reorder-gateway-rules.md)
- API Reference > environments [List environments](https://docs.islo.dev/api-reference/environments/list-environments.md)
- API Reference > environments [Create environment](https://docs.islo.dev/api-reference/environments/create-environment.md)
- API Reference > environments [Get environment](https://docs.islo.dev/api-reference/environments/get-environment.md)
- API Reference > environments [Delete environment](https://docs.islo.dev/api-reference/environments/delete-environment.md)
- API Reference > environments [Update environment](https://docs.islo.dev/api-reference/environments/update-environment.md)
- API Reference > environments [Set default environment](https://docs.islo.dev/api-reference/environments/set-default-environment.md)
- API Reference > environments [Unset default environment](https://docs.islo.dev/api-reference/environments/unset-default-environment.md)
- API Reference > cloud-roles [List cloud roles](https://docs.islo.dev/api-reference/cloud-roles/list-cloud-roles.md)
- API Reference > cloud-roles [Create cloud role](https://docs.islo.dev/api-reference/cloud-roles/create-cloud-role.md)
- API Reference > cloud-roles [Get cloud role](https://docs.islo.dev/api-reference/cloud-roles/get-cloud-role.md)
- API Reference > cloud-roles [Delete cloud role](https://docs.islo.dev/api-reference/cloud-roles/delete-cloud-role.md)
- API Reference > cloud-roles [Update cloud role](https://docs.islo.dev/api-reference/cloud-roles/update-cloud-role.md)
- API Reference > byo [Get Bring Your Own connection status](https://docs.islo.dev/api-reference/byo/get-byo-inference-status.md)
- API Reference > byo [Start Bring Your Own model setup](https://docs.islo.dev/api-reference/byo/start-byo-inference-setup.md)
- API Reference > inference [List enabled inference models](https://docs.islo.dev/api-reference/inference/list-inference-models.md)
- API Reference > container-registries [List container registries](https://docs.islo.dev/api-reference/container-registries/list-container-registries.md)
- API Reference > container-registries [Create container registry connection](https://docs.islo.dev/api-reference/container-registries/create-container-registry.md)
- API Reference > container-registries [Get container registry](https://docs.islo.dev/api-reference/container-registries/get-container-registry.md)
- API Reference > container-registries [Delete container registry](https://docs.islo.dev/api-reference/container-registries/delete-container-registry.md)
- API Reference > container-registries [Update container registry](https://docs.islo.dev/api-reference/container-registries/update-container-registry.md)
- API Reference > jobs [Validate job manifest without deploying](https://docs.islo.dev/api-reference/jobs/validate-job-manifest.md)
- API Reference > jobs [Deploy job manifest](https://docs.islo.dev/api-reference/jobs/deploy-job.md)
- API Reference > jobs [Get job metadata](https://docs.islo.dev/api-reference/jobs/get-job.md)
- API Reference > jobs [Delete job](https://docs.islo.dev/api-reference/jobs/delete-job.md)
- API Reference > jobs [List jobs](https://docs.islo.dev/api-reference/jobs/list-jobs.md)
- API Reference > jobs [List deployed versions](https://docs.islo.dev/api-reference/jobs/list-job-versions.md)
- API Reference > jobs [Get deployed version](https://docs.islo.dev/api-reference/jobs/get-job-version.md)
- API Reference > jobs [List job runs](https://docs.islo.dev/api-reference/jobs/list-job-runs.md)
- API Reference > jobs [Trigger a job run](https://docs.islo.dev/api-reference/jobs/trigger-job-run.md)
- API Reference > jobs [Get job run status](https://docs.islo.dev/api-reference/jobs/get-job-run.md)
- API Reference > jobs [Stop a job run](https://docs.islo.dev/api-reference/jobs/stop-job-run.md)
- API Reference > jobs [Get job schedule](https://docs.islo.dev/api-reference/jobs/get-job-schedule.md)
- API Reference > jobs [Disable job schedule](https://docs.islo.dev/api-reference/jobs/delete-job-schedule.md)
- API Reference > job-runs [List runs across all jobs](https://docs.islo.dev/api-reference/job-runs/list-all-job-runs.md)
- API Reference > job-runs [Get a job run by ID (without specifying job name)](https://docs.islo.dev/api-reference/job-runs/get-job-run-by-id.md)
- API Reference > factory [Validate line manifest without deploying](https://docs.islo.dev/api-reference/factory/validate-factory-line-manifest.md)
- API Reference > factory [Deploy line manifest](https://docs.islo.dev/api-reference/factory/deploy-factory-line.md)
- API Reference > factory [List factory lines](https://docs.islo.dev/api-reference/factory/list-factory-lines.md)
- API Reference > factory [Get factory line metadata](https://docs.islo.dev/api-reference/factory/get-factory-line.md)
- API Reference > factory [Update factory line](https://docs.islo.dev/api-reference/factory/update-factory-line.md)
- API Reference > factory [List line versions](https://docs.islo.dev/api-reference/factory/list-factory-line-versions.md)
- API Reference > factory [List runs for one line](https://docs.islo.dev/api-reference/factory/list-factory-line-runs-for-line.md)
- API Reference > factory [Trigger a line run](https://docs.islo.dev/api-reference/factory/trigger-factory-line-run.md)
- API Reference > factory [List line runs across all lines](https://docs.islo.dev/api-reference/factory/list-factory-line-runs.md)
- API Reference > factory [Get line run execution trace](https://docs.islo.dev/api-reference/factory/get-factory-line-run.md)
- API Reference > factory [Get line run failure diagnostics](https://docs.islo.dev/api-reference/factory/get-factory-line-run-debug.md)
- API Reference > factory [Get line schedule](https://docs.islo.dev/api-reference/factory/get-factory-line-schedule.md)
- API Reference > factory [Create or update line schedule](https://docs.islo.dev/api-reference/factory/upsert-factory-line-schedule.md)
- API Reference > factory [Disable line schedule](https://docs.islo.dev/api-reference/factory/delete-factory-line-schedule.md)
- API Reference > compute-events [Get compute event detail by command ID](https://docs.islo.dev/api-reference/compute-events/get-compute-event.md)
- API Reference > sandboxes [List sandboxes](https://docs.islo.dev/api-reference/sandboxes/list-sandboxes.md)
- API Reference > sandboxes [Create sandbox](https://docs.islo.dev/api-reference/sandboxes/create-sandbox.md)
- API Reference > sandboxes [Get sandbox by ID](https://docs.islo.dev/api-reference/sandboxes/get-sandbox-by-id.md)
- API Reference > sandboxes [Get sandbox](https://docs.islo.dev/api-reference/sandboxes/get-sandbox.md)
- API Reference > sandboxes [Delete sandbox](https://docs.islo.dev/api-reference/sandboxes/delete-sandbox.md)
- API Reference > sandboxes [Stream sandbox creation events](https://docs.islo.dev/api-reference/sandboxes/sandbox-creation-events.md)
- API Reference > sandboxes [Start command](https://docs.islo.dev/api-reference/sandboxes/exec-in-sandbox.md)
- API Reference > sandboxes [Stream command output](https://docs.islo.dev/api-reference/sandboxes/exec-in-sandbox-stream.md)
- API Reference > sandboxes [Get command result](https://docs.islo.dev/api-reference/sandboxes/get-exec-result.md)
- API Reference > sandboxes [Download file](https://docs.islo.dev/api-reference/sandboxes/download-file.md)
- API Reference > sandboxes [Upload file](https://docs.islo.dev/api-reference/sandboxes/upload-file.md)
- API Reference > sandboxes [Download archive](https://docs.islo.dev/api-reference/sandboxes/download-archive.md)
- API Reference > sandboxes [Upload archive](https://docs.islo.dev/api-reference/sandboxes/upload-archive.md)
- API Reference > sandboxes [Pause sandbox](https://docs.islo.dev/api-reference/sandboxes/pause-sandbox.md)
- API Reference > sandboxes [Resume sandbox](https://docs.islo.dev/api-reference/sandboxes/resume-sandbox.md)
- API Reference > sandboxes [List sessions](https://docs.islo.dev/api-reference/sandboxes/list-sessions.md)
- API Reference > sandboxes [Create session](https://docs.islo.dev/api-reference/sandboxes/create-session.md)
- API Reference > sandboxes [Delete session](https://docs.islo.dev/api-reference/sandboxes/kill-session.md)
- API Reference > sandboxes [Stop sandbox](https://docs.islo.dev/api-reference/sandboxes/stop-sandbox.md)
- API Reference > shares [List shares](https://docs.islo.dev/api-reference/shares/list-shares.md)
- API Reference > shares [Create share](https://docs.islo.dev/api-reference/shares/create-share.md)
- API Reference > shares [Revoke share](https://docs.islo.dev/api-reference/shares/revoke-share.md)
- API Reference > snapshots [List snapshots](https://docs.islo.dev/api-reference/snapshots/list-snapshots.md)
- API Reference > snapshots [Create snapshot](https://docs.islo.dev/api-reference/snapshots/create-snapshot.md)
- API Reference > snapshots [Get snapshot](https://docs.islo.dev/api-reference/snapshots/get-snapshot.md)
- API Reference > snapshots [Delete snapshot](https://docs.islo.dev/api-reference/snapshots/delete-snapshot.md)
- API Reference > webhooks [List incoming webhooks](https://docs.islo.dev/api-reference/webhooks/list-incoming-webhooks.md)
- API Reference > webhooks [Create incoming webhook](https://docs.islo.dev/api-reference/webhooks/create-incoming-webhook.md)
- API Reference > webhooks [Get incoming webhook](https://docs.islo.dev/api-reference/webhooks/get-incoming-webhook.md)
- API Reference > webhooks [Delete incoming webhook](https://docs.islo.dev/api-reference/webhooks/delete-incoming-webhook.md)
- API Reference > webhooks [Update incoming webhook](https://docs.islo.dev/api-reference/webhooks/update-incoming-webhook.md)
- API Reference > webhooks [List webhook deliveries](https://docs.islo.dev/api-reference/webhooks/list-webhook-deliveries.md)
- API Reference > webhooks [Get webhook delivery detail](https://docs.islo.dev/api-reference/webhooks/get-webhook-delivery.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.islo.dev/openapi.json)
- [OpenAPI YAML](https://docs.islo.dev/openapi.yaml)