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

# Quick Start

> Deploy your first agent in under 5 minutes

# Quick Start

Deploy your first Claude agent in under 5 minutes.

<Info>
  **Prerequisites:** Node.js 18+ and npm installed.
</Info>

<Tip>
  **Using Claude Code?** Type `/castari-deploy` and the skill handles all of these steps for you. Install it with `npx skills add castari/cli`. [Learn more](/guides/claude-code).
</Tip>

<Steps>
  <Step title="Install the CLI">
    ```bash theme={null}
    npm install -g @castari/cli
    ```

    Verify installation:

    ```bash theme={null}
    cast --version
    ```
  </Step>

  <Step title="Login to Castari">
    ```bash theme={null}
    cast login
    ```

    This opens your browser to authenticate. Once complete, you'll see:

    ```
    ✓ Logged in as you@example.com
    ```
  </Step>

  <Step title="Create your first agent">
    ```bash theme={null}
    cast init my-agent
    ```

    Select the `default` template when prompted. This creates a coding agent with file and bash tools.

    ```
    ? Select a template:
    ❯ default — Coding agent with file and bash tools (like Claude Code)
      research-agent — Deep research with web search and document synthesis
      support-agent — Customer support with ticket handling and escalation
      mcp-tools — Agent with example MCP server integration

    ✓ Created my-agent/ from default template
    ✓ Installed dependencies
    ```
  </Step>

  <Step title="Deploy your agent">
    ```bash theme={null}
    cd my-agent
    cast deploy
    ```

    Wait for deployment to complete:

    ```
    ⠋ Deploying my-agent...
    ✓ Agent 'my-agent' deployed!
    ```
  </Step>

  <Step title="Invoke your agent">
    ```bash theme={null}
    cast invoke my-agent "What files are in the current directory?"
    ```

    Your agent responds:

    ```
    The current directory contains:
    - src/index.ts
    - package.json
    - castari.json
    - CLAUDE.md
    - README.md
    ```
  </Step>
</Steps>

## You did it!

Your agent is deployed and running. Here's what you can do next:

<CardGroup cols={2}>
  <Card title="Customize Your Agent" icon="pen" href="/guides/custom-agents">
    Edit the code and CLAUDE.md to change behavior
  </Card>

  <Card title="Add Secrets" icon="key" href="/cli/secrets">
    Add API keys and environment variables
  </Card>

  <Card title="Try Other Templates" icon="grid" href="/guides/templates">
    Research agents, support agents, and more
  </Card>

  <Card title="Use the SDK" icon="code" href="/sdk/overview">
    Invoke agents programmatically
  </Card>
</CardGroup>