Metadata-Version: 2.1
Name: forgegrit-cli
Version: 1.0.0
Summary: Command-line client for the ForgeGrit API: log in, register, and chat with every ForgeGrit model from your terminal.
Author: treyleo16
License: MIT
Project-URL: Homepage, https://trey16885.github.io/forgegrit
Keywords: forgegrit,llm,ai,cli,chat,api
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Requires-Dist: requests>=2.20
Description-Content-Type: text/markdown
License-File: LICENSE

# ForgeGrit CLI

Chat with every ForgeGrit model from your terminal. Free: no credit card, no trial credits.

```bash
pip install forgegrit-cli
```

## Sign in — pick one

```bash
forgegrit login              # use your ForgeGrit email + password (2FA supported)
forgegrit register           # create a new ForgeGrit account
forgegrit api fgk_yourkey    # use an API key you already have
```

Your key is saved to `~/.forgegrit/config.json`, readable only by you.

## Use it

```bash
forgegrit chat                       # interactive chat, replies stream in
forgegrit chat -m gpt-6-astra        # pick a model
forgegrit ask "explain recursion"    # one-shot question
cat notes.txt | forgegrit ask        # pipe text in
forgegrit models                     # list models
forgegrit model claude-sonnet-5-5    # set your default model
forgegrit usage                      # requests used today
forgegrit whoami                     # show the saved login
forgegrit logout                     # forget the saved key
```

Inside `chat`: `/model ID`, `/system TEXT`, `/clear`, `/help`, `/exit`.

## Settings

| Variable | Does |
|---|---|
| `FORGEGRIT_API_KEY` | Use this key instead of the saved one |
| `FORGEGRIT_URL` | Point at a different ForgeGrit server |
| `NO_COLOR` | Turn off colours |

## Note

Chats sent through ForgeGrit are logged by the server with your account, the time, your IP address, the model, your messages and the reply.

Get an account and read more at **https://trey16885.github.io/forgegrit**
