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

> ## Agent Instructions
> Treat Clawdi as one product.
> Recommend the Cloud Agent quickstart for most new users.
> Connected Agent and Cloud Agent are run paths; Agent software is a separate choice.
> Do not present shared Clawdi capabilities as exclusive to one run path.

# Connect a local Agent

> Install the Clawdi CLI and connect supported Agent software on your computer.

This is the **Connected Agent** quickstart. Use it when Agent software already
runs on your computer and needs access to that computer or its local tools.

<Note>
  Most new users should start with the [Cloud Agent
  quickstart](/cloud-agents/deploy), which does not require a local
  installation.
</Note>

For a guided dashboard entry, follow [Ask your agent](/getting-started/connect-agents#connect-from-the-dashboard)
and copy the current setup prompt from the [Clawdi dashboard](https://cloud.clawdi.ai)
into your local Agent. Complete authorization yourself and verify the result.
The manual steps below give you control over each stage.

## Before you begin

* Review [System requirements](/installation/requirements). Native installers
  on macOS, Linux, and Windows do not require Node.js. For an npm-managed
  installation, install Node.js 24 or newer.
* Install at least one [supported Agent software
  option](/getting-started/connect-agents#supported-agent-software) if you want
  `clawdi setup` to detect it automatically.

## Steps

<Steps>
  <Step title="Install the Clawdi CLI">
    Run the installer as your normal user:

    <Tabs>
      <Tab title="macOS and Linux">
        ```bash theme={null}
        curl -fsSL https://clawdi.ai/install.sh | sh
        ```

        Run without `sudo`.
      </Tab>

      <Tab title="Windows">
        ```powershell theme={null}
        irm https://clawdi.ai/install.ps1 | iex
        ```
      </Tab>
    </Tabs>

    For a package-manager alternative, follow the
    [npm installation instructions](/installation#npm-installation), then
    continue with sign-in below.
  </Step>

  <Step title="Sign in">
    ```bash theme={null}
    clawdi auth login
    ```

    Open the printed sign-in link, confirm the page shows the same code as the
    terminal, and approve. The CLI finishes automatically. On SSH or a
    headless machine, open the link on any device with a browser. See
    [Authentication](/account/authentication) for code expiry, interrupted
    sign-ins, and local credential safeguards.
  </Step>

  <Step title="Connect the Agent">
    ```bash theme={null}
    clawdi setup
    ```

    Select the detected Agent software you want to connect. Setup registers an
    Agent and starts background sync by default. It also adds the Clawdi MCP
    entry and bundled Skill where supported. Pi and OpenCode sync Sessions
    only; see the [support table](/getting-started/connect-agents#supported-agent-software).
  </Step>

  <Step title="Check the setup">
    ```bash theme={null}
    clawdi doctor
    ```

    A healthy setup reports successful checks for authentication, API
    reachability, registered Agents, Vault metadata, and Clawdi MCP. Agent
    software not installed on this computer can appear as unavailable without
    preventing an installed Agent from working.
  </Step>
</Steps>

<Check>
  Your Connected Agent is ready. Open **Sessions** in the dashboard to check
  its synced history. For integrations with MCP setup, start a new Agent
  Session and ask what Clawdi tools are available.
</Check>

## Next steps

<CardGroup cols={2}>
  <Card title="Connect another local Agent" icon="plug" href="/getting-started/connect-agents">
    Select a specific Agent software option and verify its local integration.
  </Card>

  <Card title="Learn the core concepts" icon="blocks" href="/concepts/core-concepts">
    Understand the objects that stay consistent across Agent workflows.
  </Card>

  <Card title="Browse guides" icon="book-open" href="/guides">
    Follow task guides for Projects, Memories, Sessions, Skills, Vaults,
    Connectors, Channels, and AI Providers.
  </Card>

  <Card title="Keep the CLI current" icon="refresh-cw" href="/installation/update">
    Check for a release and update through the same installation owner.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.