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

# Quick Start

> Get swAItch running in under 2 minutes

## Install

<CodeGroup>
  ```bash pip theme={null}
  pip install swaitch
  ```

  ```bash uv (recommended) theme={null}
  uv pip install swaitch
  ```

  ```bash From source theme={null}
  git clone https://github.com/ramraaj25/swAItch.git
  cd swaitch
  uv pip install -e ".[dev]"
  ```
</CodeGroup>

## Run the server

### stdio mode (default)

For MCP clients like Cursor or Claude Desktop:

```bash theme={null}
swaitch run
```

### HTTP mode

For remote access or web integrations:

```bash theme={null}
swaitch run --transport http --port 8000
```

## Connect from your IDE

Add swAItch to your MCP client configuration:

<CodeGroup>
  ```json Cursor / Claude Desktop theme={null}
  {
    "mcpServers": {
      "swaitch": {
        "command": "swaitch",
        "args": [
          "run"
        ]
      }
    }
  }
  ```
</CodeGroup>

## Use it

Once connected, just tell your AI assistant what you need:

<Steps>
  <Step title="Discover sources">
    Ask: *"What IDE conversations do I have available?"*

    The agent calls `list_sources` and shows you which IDEs have data.
  </Step>

  <Step title="Browse conversations">
    Ask: *"Show me my Cursor conversations"*

    The agent calls `list_conversations` and lists them with titles and summaries.
  </Step>

  <Step title="Import context">
    Ask: *"Bring in the authentication architecture discussion"*

    The agent calls `get_conversation` and retrieves the full context — messages, plans, and all artifacts.
  </Step>
</Steps>

## What's next?

<CardGroup cols={2}>
  <Card title="Tools Reference" icon="wrench" href="/tools-reference">
    Full documentation for all MCP tools.
  </Card>

  <Card title="Architecture" icon="sitemap" href="/architecture">
    Understand how swAItch works under the hood.
  </Card>
</CardGroup>