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

# Guides overview

> Task-oriented walkthroughs for the CLI and the TypeScript SDK.

Amika gives you two main ways to drive sandboxes: the `amika` CLI for
day-to-day shell use, and the `@amika/sdk` TypeScript SDK for programs and
pipelines. The guides in this section walk through one task at a time and
show both side-by-side, so you can pick whichever interface fits the job.

## Where to start

<CardGroup cols={2}>
  <Card title="Create a sandbox" icon="cube" href="/guides/create-a-sandbox">
    Spin up a sandbox loaded with your repo and agent credentials.
  </Card>

  <Card title="Send a message to an agent" icon="paper-plane" href="/guides/send-a-message-to-an-agent">
    Run Claude, Codex, or another agent inside a sandbox synchronously.
  </Card>

  <Card title="Manage secrets" icon="key" href="/guides/manage-secrets">
    Store API keys and OAuth credentials in the Amika vault.
  </Card>

  <Card title="Inject credentials" icon="syringe" href="/guides/inject-credentials">
    Wire stored credentials into a sandbox at create time.
  </Card>
</CardGroup>

## CLI and SDK in one place

Every guide shows the same step with a `<CodeGroup>`: the CLI snippet first,
the TypeScript snippet second. Use whichever tab matches the surface you're
working in.

<CodeGroup>
  ```bash CLI theme={null}
  amika sandbox create --name dev-box --preset coder
  ```

  ```ts TypeScript theme={null}
  import { AmikaClient } from "@amika/sdk";

  const amika = new AmikaClient({
    baseUrl: process.env.AMIKA_API_URL ?? "https://app.amika.dev",
    accessToken: process.env.AMIKA_API_KEY!,
  });

  await amika.createSandbox({ name: "dev-box", preset: "coder" });
  ```
</CodeGroup>

## What you need

* An Amika account on the hosted platform at [app.amika.dev](https://app.amika.dev).
* For the CLI: install it (see [Install](/install)) and run `amika auth login`.
* For the SDK: an Amika API key from
  [app.amika.dev/settings](https://app.amika.dev/settings) and `npm install @amika/sdk`.

<Note>
  The SDK does not read `AMIKA_API_KEY` from your environment or disk. The
  caller is responsible for sourcing the token. The CLI handles credential
  storage for you.
</Note>

## See also

<CardGroup cols={3}>
  <Card title="TypeScript SDK" icon="code" href="/sdks/typescript/quickstart">
    Method-by-method reference, types, and errors.
  </Card>

  <Card title="CLI reference" icon="square-terminal" href="/reference/cli">
    Full flag listing for every `amika` command.
  </Card>

  <Card title="HTTP API" icon="cloud" href="/reference/api-reference">
    Interactive docs and OpenAPI spec for the hosted API.
  </Card>
</CardGroup>