cw-relay 0.2.0

A Claude Code-style terminal chatbot with file and shell access. Supports Gemini and Groq.

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

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