# Komet

Komet is a Groq-powered CLI assistant with an interactive chat mode and an AI commit workflow.

## Install

```bash
pip install ikomet
```

No local project virtualenv is required for end users.

If your Linux distro blocks global `pip` installs (PEP 668), use one of:

```bash
pipx install ikomet
```

or

```bash
python3 -m pip install --user --break-system-packages ikomet
```

## Usage

Default behavior is interactive chat mode:

```bash
ikomet
```

Set or update your Groq API key (stored locally at `~/.komet/config.json`):

```bash
ikomet -k gsk_your_key_here
```

Run commit workflow (stage all, generate message, approve/regenerate/edit, commit):

```bash
ikomet -c
```

Commit and push:

```bash
ikomet -cp
```

Equivalent form:

```bash
ikomet -c -p
```

## Notes

- Uses Groq API model `llama-3.1-8b-instant`
- Commit mode supports:
  - approve
  - regenerate
  - edit
  - quit
- Conventional commit style is used for generated commit messages

## License

MIT. See [LICENSE](LICENSE).