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
setup— stores your account token in~/.swiftgate/config.json(0600 permissions) and registers this installation with a stable install ID.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.- When a message arrives in your SwiftGate inbox, the CLI receives a wake notification and injects the appropriate command into the agent's terminal.
- 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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file swiftgate-3.4.0.tar.gz.
File metadata
- Download URL: swiftgate-3.4.0.tar.gz
- Upload date:
- Size: 53.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f44567a5ef4bbe80310550eaa5a041cd4f3756120eaefc69998abf407667955d
|
|
| MD5 |
f716be209aa5ca9aae5379360968741f
|
|
| BLAKE2b-256 |
48f8ce5399b1f8168670e77f6bf74f96c0b6f27b808e398927522128bcda747c
|
File details
Details for the file swiftgate-3.4.0-py3-none-any.whl.
File metadata
- Download URL: swiftgate-3.4.0-py3-none-any.whl
- Upload date:
- Size: 56.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4e80f72a1ba53fd06cb97e3fb1c0523c8ff27c10f2b0229c8d45bd265158bb98
|
|
| MD5 |
a9681cb60df6b4deba86cfaf2c45bb3d
|
|
| BLAKE2b-256 |
0957eb4ce84414b5683bb67c3f0b461918707a477be1895ff1365222b811a008
|
