swytchcode
v2.23.3
Published
Execution authority layer for API integrations
Readme
swytchcode
Execution authority for agentic API integrations.
Swytchcode sits between AI agents and production APIs - ensuring every tool call is explicit, auditable, and controlled by your project configuration.
Try it instantly
npx swytchcode stripe.create_paymentNo installation, no API keys, no project setup. Runs in demo mode and returns a real sandbox response from Stripe's test environment.
Not sure what a command does? Add --explain:
npx swytchcode stripe.create_payment --explainInstall
macOS / Linux:
curl -fsSL https://cli.swytchcode.com/install.sh | shWindows (PowerShell):
irm https://cli.swytchcode.com/install.ps1 | iexnpm (all platforms):
npm install -g swytchcodeThe correct binary for your platform (macOS, Linux, Windows - x64 and arm64) is selected automatically.
Security & Execution Policy Note (Windows): The npm package uses a
postinstallscript to delete the.ps1wrapper files generated by npm. This forces PowerShell to fall back to the.cmdwrapper, bypassing the defaultRestrictedexecution policy so the CLI runs out of the box.
- Scanners: Automated supply-chain scanners (e.g. Socket.dev) may flag this postinstall script because it deletes files outside the package directory. This is benign and limited only to removing the npm-generated shims.
- --ignore-scripts: If you install with
npm install -g swytchcode --ignore-scripts(or have it set in your config), the postinstall cleanup won't run. You can run the CLI by explicitly invokingswytchcode.cmd(orswy.cmd). To use the unqualifiedswytchcodecommand in PowerShell, you must explicitly opt in by runningSet-ExecutionPolicy RemoteSigned -Scope CurrentUser.
Usage
swytchcode exec <canonical-id> Execute a tool
swytchcode list List available tools
swytchcode search <query> Search tools by keyword or intent
swytchcode info <canonical-id> Show tool details
swytchcode init Set up a project
swytchcode --help Show all commandsOfficial language runtimes
Use these packages to call swytchcode exec directly from your code without shell boilerplate:
| Language | Package | Install |
|----------|---------|---------|
| TypeScript / JavaScript | @swytchcode/runtime | npm install @swytchcode/runtime |
| Python | swytchcode-runtime | pip install swytchcode-runtime |
| Go | gitlab.com/swytchcode/go-runtime | go get gitlab.com/swytchcode/go-runtime |
All runtimes resolve the swytchcode binary from $PATH by default. Set SWYTCHCODE_BIN=/path/to/binary to override - useful in CI, Docker, or environments where the global symlink is not available.
