Quick Start

Get swAItch running in under 2 minutes

Install

pip

pip install swaitch

uv pip install swaitch

git clone https://github.com/ramraaj25/swAItch.git
cd swaitch
uv pip install -e ".[dev]"

Run the server

stdio mode (default)

For MCP clients like Cursor or Claude Desktop:

swaitch run

HTTP mode

For remote access or web integrations:

swaitch run --transport http --port 8000

Connect from your IDE

Add swAItch to your MCP client configuration:

Cursor / Claude Desktop

{
  "mcpServers": {
    "swaitch": {
      "command": "swaitch",
      "args": [
        "run"
      ]
    }
  }
}

Use it

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

1. Discover sources

   Ask: “What IDE conversations do I have available?”

   The agent calls list_sources and shows you which IDEs have data.

2. Browse conversations

   Ask: “Show me my Cursor conversations”

   The agent calls list_conversations and lists them with titles and summaries.

3. Import context

   Ask: “Bring in the authentication architecture discussion”

   The agent calls get_conversation and retrieves the full context — messages, plans, and all artifacts.

What’s next?

Tools Reference

Full documentation for all MCP tools.

Architecture

Understand how swAItch works under the hood.