relay
A Claude Code-style terminal chatbot, powered by Google Gemini, with direct file and shell access.
┌─────────────────────────────────────────┐
│ relay · terminal chat (Gemini) │
└─────────────────────────────────────────┘
Install
macOS / Linux (recommended):
brew install casperwhite-commits/tap/cw-relay
Anywhere with Python 3.10+:
pip install cw-relay
Setup
You need a Google Gemini API key — grab a free one at aistudio.google.com.
relay --set-key
(Paste at the hidden prompt — Cmd+V / Ctrl+V works even though nothing visibly happens.)
Or set the GEMINI_API_KEY environment variable, which takes precedence over the stored config.
Use
relay
Type to chat. Relay can read files, search your filesystem, run shell commands, and write files on its own when the conversation calls for it.
Commands
| command | action |
|---|---|
/help |
show command list |
/exit, /quit |
leave |
/clear |
reset the conversation |
/cls |
clear the screen, keep the conversation |
/model <name> |
switch model (e.g. gemini-2.5-pro) |
/system <text> |
replace the system instruction |
/cwd <path> |
change working directory |
/save <path> |
save the transcript to a file |
Tools the assistant uses automatically
list_directory · read_file · glob_files · grep_files · write_file · run_shell · fetch_url · web_search
Safety
Relay gives the model direct shell access on your machine. It will run commands and modify files without asking. Don't point it at machines you don't own, and consider reviewing the conversation as it runs.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for cw-relay 0.4.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 | |
|---|---|---|---|
| cw_relay-0.4.0.tar.gz | 13.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cw_relay-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 27.3 kB
Release files / cw_relay-0.4.0.tar.gz
| Download URL | cw_relay-0.4.0.tar.gz |
|---|---|
| Size | 13.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0b48301abc8f5f0a8117e3eea0e24ddff23367f86b6b8b447c5315e63b9ec320
|
|
BLAKE2b-256 checksum How to use checksums |
c2520ba83ffd5dc00ee211d40333d5d0fbbc74713af29de50fc9385c41f23a8e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
Release files / cw_relay-0.4.0-py3-none-any.whl
| Download URL | cw_relay-0.4.0-py3-none-any.whl |
|---|---|
| Size | 14.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d805852d54cbf1a9ba39819c6cf7ee1e944ca3f8d1372ba6a8cc1b5588ba6287
|
|
BLAKE2b-256 checksum How to use checksums |
e6342d56a3b204b317c2dcac8ae9e2dbd6868026de31234c6c8fd1cffdd487ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
