Skip to main content

cli-copilot

A terminal chat copilot powered by Groq. Replies stream live and render as Markdown, and conversations are saved so you can pick up where you left off.

Features

  • Streaming responses with Markdown rendering
  • Sessions saved per working directory; chatting again within an hour resumes the last one
  • API key stored securely in your system keyring
  • Token usage shown after each reply
  • Ctrl+C stops a reply and keeps the partial text

Install

pipx install cli-copilot
# or
uv tool install cli-copilot

Requires Python 3.12+.

Setup

Create an API key at console.groq.com/keys, then store it:

cli-copilot login

Usage

cli-copilot chat                      # start or resume a chat in this directory
cli-copilot chat --new                # force a fresh session
cli-copilot chat --model <model-id>   # choose a Groq model
cli-copilot chat --system "You are a code reviewer."

Inside a chat: /new starts a new session, /exit quits.

Other commands: login, get-key, hello, goodbye.

Data

Sessions are stored as JSONL files in your user app directory (one folder per session, with conversation.jsonl and meta.json).

Development

uv sync --group dev
uv run pytest

Metadata

Release files for cli-copilot 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cli-copilot 0.1.1
File Size Uploaded Provenance
cli_copilot-0.1.1.tar.gz 5.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for cli-copilot 0.1.1
File Interpreter ABI Platform
cli_copilot-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 12.3 kB

Release files / cli_copilot-0.1.1.tar.gz

Download URL cli_copilot-0.1.1.tar.gz
Size 5.3 kB
Tags Source
SHA-256 checksum
How to use checksums
4b7886d2bb7c7edb7e615a40c658cd0c3967c89ae8f6e5dfe0400bae4aab16ae
BLAKE2b-256 checksum
How to use checksums
68a543ca316eed50869a58c16a1e5e8578879e4740996430915ed3127f57479c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / cli_copilot-0.1.1-py3-none-any.whl

Download URL cli_copilot-0.1.1-py3-none-any.whl
Size 7.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
560b729340a3b3ab0a9c7a3e7172f01e945715fd89964ed2a475f5822c14d239
BLAKE2b-256 checksum
How to use checksums
ad051d8b605a245ef1e43376b5c5aacf36d055ef838931479f1c868e48bb1fad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for cli-copilot 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page