Skip to main content

swiftgate

Autonomous bidirectional agent bridge for SwiftGate OS.

Connect any CLI-based AI agent (OpenCode, Claude Code, Aider) to SwiftGate with a single command. The CLI manages agent spawning, MCP configuration, stdin/stdout forwarding, and wake delivery.

Runs on Linux, macOS and Windows (ConPTY).

Install

pip install swiftgate

Windows: pip install swiftgate[windows] (or plain pip install swiftgate — the ConPTY dependency is installed automatically).

Quick Start

# 1. One-time: install + register this machine
swiftgate setup --token sg_acc_...

# 2. Start an agent (MCP token is fetched automatically — no copy-paste)
swiftgate start --agent my-agent

Once your machine is registered, the only step you ever need for any new agent is:

swiftgate start --agent another-agent

Commands

Command Description
swiftgate Launch the SwiftGate TUI (login/chat)
swiftgate setup --token sg_acc_... Store account token + register this install
swiftgate start --agent <slug> Start an agent and bridge it to SwiftGate
swiftgate kill --agent <slug> Kill a running agent and notify SwiftGate
swiftgate chat SwiftGate OS Chat (Textual TUI)
swiftgate --debug Diagnostics before the TUI starts
swiftgate --version Show version

How It Works

  1. setup — stores your account token in ~/.swiftgate/config.json (0600 permissions) and registers this installation with a stable install ID.
  2. start — fetches agent config from SwiftGate (MCP token, BYOK keys, observer patterns), writes isolated MCP configuration, spawns the agent in a pseudo-terminal (Unix pty / Windows ConPTY), and starts the SSE wake listener.
  3. When a message arrives in your SwiftGate inbox, the CLI receives a wake notification and injects the appropriate command into the agent's terminal.
  4. stdin/stdout is forwarded transparently — the CLI is invisible.

Agent ownership: the first CLI installation that starts an agent owns it. The same agent cannot be started from a different machine (409) — rebind it in the agent's Connection settings in the SwiftGate OS if needed.

Supported Agents

  • OpenCode
  • Claude Code
  • Aider
  • More coming (PI, Hermes, OpenClaw)

Requirements

  • Python 3.9+
  • Linux, macOS or Windows

Metadata

Release files for swiftgate 3.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for swiftgate 3.7.0
File Size Uploaded Provenance Actions
swiftgate-3.7.0.tar.gz 70.7 kB Without provenance Details for swiftgate-3.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for swiftgate 3.7.0
File Interpreter ABI Platform Actions
swiftgate-3.7.0-py3-none-any.whl Python 3 none any Details for swiftgate-3.7.0-py3-none-any.whl

Total release size: 137.2 kB

Release files / swiftgate-3.7.0.tar.gz

Download URL swiftgate-3.7.0.tar.gz
Size 70.7 kB
Tags Source
SHA-256 checksum
How to use checksums
ef8db6a02b72d6921e5c083a37e8fc0fbe3b5cf8db0bb26fba62f5c4ddae7e52
BLAKE2b-256 checksum
How to use checksums
db881f9868de545317e56a3ed4f744e585001822e9ef0557817cdf2db5646fcb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / swiftgate-3.7.0-py3-none-any.whl

Download URL swiftgate-3.7.0-py3-none-any.whl
Size 66.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
181b2d40ee281aa6bd0e9a9995fc9774cb6c38a98421f2963ad8fcbcd2455c54
BLAKE2b-256 checksum
How to use checksums
dc8745eebb1cb8b17de2462ec1d1fd290db9b98cc198843aa9ce87ef3438094e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for swiftgate 3.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.7.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page