Skip to content

1. Install the CLI

Terminal window
npm install -g swytchcode

Use swy as a shorter alias for swytchcode.

2. Install the packages

Terminal window
pip install swytchcode-runtime crewai python-dotenv

3. Initialize Swytchcode and fetch a toolkit

Terminal window
swy init
swy get github

swy init creates .swytchcode/ and tooling.json for the project. swy get github downloads the GitHub integration bundle - the schemas that tools.get reads from in a later step.

4. List available methods

Terminal window
swy list methods

This lists every method from the integrations you’ve downloaded, so you can see what the GitHub bundle exposes before you load tools in the SDK.

5. Enable a tool and connect GitHub

Terminal window
swy add <canonical_id>
swy auth connect github

Copy a canonical ID from swy list methods. For example:

Terminal window
swy add github.issues.create

swy add writes that method into tooling.json so the SDK can execute it. swy auth connect github opens a browser so you can authorize GitHub.

6. Create the tool set

from swytchcode_runtime import Swytchcode
from swytchcode_runtime.providers.crewai import CrewAIProvider
swx = Swytchcode(provider=CrewAIProvider())
tools = swx.tools.get(toolkits=["github"])

7. Hand the tools to your crew

print(f"Loaded {len(tools)} tools for the crew")

8. Run the file

Save the example as main.py or main.js, then run the matching command:

Terminal window
python main.py

CrewAI can use those tools as normal agent tools while Swytchcode handles the execution path.