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
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.