> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runtools.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Build AI agents with cloud sandboxes, local devices, persistent workspaces, hosted tools, and cloud threads

Every AI agent eventually needs to *do* something — run code, edit files, call an API, keep state between runs. Runtools is the infrastructure for that part: private cloud sandboxes, registered local devices, persistent workspaces, hosted tools with server-side credentials, and durable thread history. Give your agent a place to work, not just a place to talk.

Drive it visually from the dashboard, or wire it into your own product with the SDK, CLI, and REST API — same platform underneath.

<CardGroup cols={2}>
  <Card title="Sandboxes" icon="server" href="/features/sandboxes">
    Create isolated Linux or desktop environments, run commands, expose dev servers, pause idle work, and connect over SSH.
  </Card>

  <Card title="Workspaces" icon="folder-tree" href="/features/workspaces">
    Persist project files, mount them into sandboxes, and give sandbox-backed agents filesystem memory across runs.
  </Card>

  <Card title="Agents" icon="robot" href="/features/agents">
    Define model, prompt, tools, execution mode, and resources. Run agents from the dashboard, CLI, SDK, REST API, or a registered device.
  </Card>

  <Card title="Tool Hub" icon="store" href="/features/tool-hub">
    Install public tools, deploy org-private tools with `defineTool()`, and let Runtools resolve OAuth or stored credentials server-side.
  </Card>

  <Card title="Product Apps" icon="cube" href="/product-apps">
    Build customer-facing agents where each end user connects their own integrations through Hosted Connect.
  </Card>

  <Card title="RunMesh" icon="server" href="/features/runmesh">
    Register devices and private nodes so local agents can run on the right machine while still writing to cloud threads.
  </Card>
</CardGroup>

## Current Public Surface

| Surface        | What you can do today                                                                                                                                                                                  |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| REST API       | Sandboxes, workspaces, workspace files, agents, agent runs, threads, model availability/proxy, RunMesh devices, activity, billing, SSH keys, API keys, tool execution, installable agents, and secrets |
| TypeScript SDK | `RunTools` plus `rt.sandbox`, `rt.agent`, `rt.tools`, `rt.connect`, `rt.workspaces`, `rt.secrets`, `rt.billing`, `rt.threads`, `rt.sshKeys`, `rt.devices`, and `rt.installableAgents`                  |
| CLI            | Auth, OAuth, project init/deploy, sandboxes with workspace mounts, agents, tools, secrets, SSH keys, usage, threads, devices, and installable agents                                                   |
| Dashboard      | Chats, agents, sandboxes, workspaces, Tool Hub, credentials, billing, support, settings, and team management                                                                                           |

## Quick Example

```typescript theme={null}
import { RunTools } from '@runtools-ai/sdk';

const rt = new RunTools({ apiKey: process.env.RUNTOOLS_API_KEY });

const sandbox = await rt.sandbox.create({
  name: 'docs-demo',
  template: 'base-ubuntu',
});

await sandbox.waitForReady();

const result = await sandbox.exec('node --version');
console.log(result.stdout);

await sandbox.pause();
```

## Where To Start

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Create an API key, run the CLI, and create a sandbox.
  </Card>

  <Card title="Core Concepts" icon="lightbulb" href="/concepts">
    Understand sandboxes, agents, tools, projects, and credentials.
  </Card>

  <Card title="Product Apps" icon="cube" href="/product-apps">
    Build SaaS-style products where your own users connect their own tools.
  </Card>

  <Card title="Hosted Connect" icon="plug" href="/sdk/hosted-connect">
    Add end-user OAuth and API-key integrations to your product.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Use the REST APIs directly.
  </Card>

  <Card title="SDK" icon="cube" href="/sdk/overview">
    Use the TypeScript SDK in your application.
  </Card>

  <Card title="Threads" icon="book-open" href="/api-reference/threads">
    Cloud thread history, live WebSocket frames, compaction, and local runtime event publishing.
  </Card>
</CardGroup>