---
title: Overview
url: /sdks/go/0.1.8/api/overview/
docset: sdk-go
version: 0.1.8
latest_version: 0.1.8
source: ai-openshell/sdk-go@v0.1.8:docs/src/api/overview.md
---

> Documentation index: /sdks/go/0.1.8/llms.txt. This page is for Go SDK 0.1.8.

# Overview

The OpenShell Go SDK exposes typed interfaces through the sub-client pattern.
You access each interface through a typed accessor on the concrete `Client`.

## Interface Summary

### Top-Level Interfaces

| Interface                                                         | Accessor                    | Description                                       |
| ----------------------------------------------------------------- | --------------------------- | ------------------------------------------------- |
| [SandboxInterface](/sdks/go/0.1.8/api/sandboxes/)                 | `client.Sandboxes()`        | Create, manage, and watch sandbox lifecycle       |
| [SandboxTemplateInterface](/sdks/go/0.1.8/api/sandbox-templates/) | `client.SandboxTemplates()` | Manage reusable sandbox templates                 |
| [ExecInterface](/sdks/go/0.1.8/api/exec/)                         | `client.Exec()`             | Run commands, stream output, interactive sessions |
| [ProviderInterface](/sdks/go/0.1.8/api/providers/)                | `client.Providers()`        | Manage compute providers and their lifecycle      |
| [ServiceInterface](/sdks/go/0.1.8/api/services/)                  | `client.Services()`         | Expose and manage HTTP services inside sandboxes  |
| [FileInterface](/sdks/go/0.1.8/api/files/)                        | `client.Files()`            | Upload and download files to/from sandboxes       |
| [HealthInterface](/sdks/go/0.1.8/api/health/)                     | `client.Health()`           | Check gateway health status                       |
| [SSHInterface](/sdks/go/0.1.8/api/ssh/)                           | `client.SSH()`              | Create SSH sessions and tunnels to sandboxes      |
| [TCPInterface](/sdks/go/0.1.8/api/tcp/)                           | `client.TCP()`              | Forward TCP connections to sandbox ports          |
| [ConfigInterface](/sdks/go/0.1.8/api/config/)                     | `client.Config()`           | Read and update sandbox and gateway configuration |
| [PolicyInterface](/sdks/go/0.1.8/api/policy/)                     | `client.Policy()`           | Manage draft policy recommendations               |

### Convenience Packages

| Package                                | Entry Point               | Description                                    |
| -------------------------------------- | ------------------------- | ---------------------------------------------- |
| [gateway](/sdks/go/0.1.8/api/gateway/) | `gateway.NewClient(name)` | Read CLI gateway configs and auto-wire clients |

### Provider Sub-Interfaces

These are accessed through `client.Providers()`:

| Interface                                        | Accessor                        | Description                             |
| ------------------------------------------------ | ------------------------------- | --------------------------------------- |
| [ProfileInterface](/sdks/go/0.1.8/api/profiles/) | `client.Providers().Profiles()` | Manage provider type profiles           |
| [RefreshInterface](/sdks/go/0.1.8/api/refresh/)  | `client.Providers().Refresh()`  | Configure credential refresh strategies |

## Interfaces

Each interface has a reference page with method signatures and usage examples:

- **[Sandboxes](/sdks/go/0.1.8/api/sandboxes/)**: Create sandboxes, wait for readiness, watch state changes, manage providers, retrieve logs.
- **[Sandbox Templates](/sdks/go/0.1.8/api/sandbox-templates/)**: Create reusable workload templates and launch sandboxes from them.
- **[Exec](/sdks/go/0.1.8/api/exec/)**: Execute commands with one-shot, streaming, or interactive modes.
- **[Providers](/sdks/go/0.1.8/api/providers/)**: Register and manage compute providers. Includes sub-clients for profiles and credential refresh.
- **[Services](/sdks/go/0.1.8/api/services/)**: Expose and manage HTTP services inside sandboxes.
- **[Files](/sdks/go/0.1.8/api/files/)**: Upload and download files to/from sandboxes.
- **[Health](/sdks/go/0.1.8/api/health/)**: Check gateway health status.
- **[SSH](/sdks/go/0.1.8/api/ssh/)**: Create SSH sessions and tunnels to sandboxes.
- **[TCP](/sdks/go/0.1.8/api/tcp/)**: Forward TCP connections to sandbox ports.
- **[Config](/sdks/go/0.1.8/api/config/)**: Read and update sandbox and gateway configuration.
- **[Policy](/sdks/go/0.1.8/api/policy/)**: Manage draft policy recommendations.
- **[Profiles](/sdks/go/0.1.8/api/profiles/)**: Manage provider type profiles (via `client.Providers().Profiles()`).
- **[Refresh](/sdks/go/0.1.8/api/refresh/)**: Configure credential refresh strategies (via `client.Providers().Refresh()`).

## Common Patterns

SDK methods follow these conventions:

- Network operations take `context.Context`; list constructors return a pager,
  and each `NextPage` call accepts the request context
- Methods that can fail return `(result, error)`
- List methods accept variadic options and `ListAll` is the explicit exhaustive path
- Errors from the gateway carry a `StatusError` with a typed code (see [Error Handling](/sdks/go/0.1.8/error-handling/))
