Metadata-Version: 2.4
Name: cw-relay
Version: 0.2.0
Summary: A Claude Code-style terminal chatbot with file and shell access. Supports Gemini and Groq.
Project-URL: Homepage, https://github.com/casperwhite-commits/relay
Project-URL: Issues, https://github.com/casperwhite-commits/relay/issues
Author: Casper White
License: MIT
License-File: LICENSE
Keywords: ai,assistant,chat,cli,gemini,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: google-genai>=0.3.0
Requires-Dist: groq>=0.11.0
Requires-Dist: rich>=13.0.0
Description-Content-Type: text/markdown

# 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):**

```bash
brew install casperwhite-commits/tap/cw-relay
```

**Anywhere with Python 3.10+:**

```bash
pip install cw-relay
```

## Setup

You need a Google Gemini API key — grab a free one at [aistudio.google.com](https://aistudio.google.com/app/apikey).

```bash
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

```bash
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
