Skip to main content

CLI AI‑Copilot assistant

Project description

aye

Command-Line Interface AI-Copilot tool

Aye is a tiny terminal‑only AI assistant that:

  • generates code from natural‑language prompts,
  • automatically snapshots the target file before each change,
  • lets you list, view, and revert those snapshots (aye snap …),
  • uses a simple token‑based authentication model (no Cognito required).

Quick start

# Install from PyPI
pip install aye-cli

# Authenticate (you’ll get a token from your backend)
aye login

# One‑shot generation
aye generate "create a Python function that parses CSV" -f utils.py

# Interactive chat (optional)
aye chat -f utils.py

# Undo / snapshot utilities
aye snap list utils.py
aye snap show utils.py 20241012T153045
aye snap revert utils.py 20241012T153045

Development

# Clone the repo
git clone https://github.com/yourorg/aye.git
cd aye

# Create a virtual environment
python -m venv .venv && source .venv/bin/activate

# Install in editable mode with dev deps
pip install -e .[dev]

# Run the test suite
pytest -q

Packaging & distribution

# Build a wheel and source distribution
python -m build

# Install the wheel locally for a clean test
pip install dist/aye_cli-0.1.0-py3-none-any.whl

The console script aye will be available on the PATH.
License

MIT  see the LICENSE file (or the license header in pyproject.toml).
Contributing

Feel free to open issues or submit pull requests.
All contributions are welcome; just follow the usual GitHub workflow.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aye_cli-0.1.0.tar.gz (7.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aye_cli-0.1.0-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

Details for the file aye_cli-0.1.0.tar.gz.

File metadata

  • Download URL: aye_cli-0.1.0.tar.gz
  • Upload date:
  • Size: 7.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for aye_cli-0.1.0.tar.gz
Algorithm Hash digest
SHA256 dda10e416b0bf9f0b7a2bb7d6f78848cf348da2548811486d2bb6ebc75fa77cd
MD5 5577946952c38985850596f4763a5ce3
BLAKE2b-256 8285dc666f9e9245b1550c957d7df35b4540c3c7d0fe2071a88216cc0d3456b5

See more details on using hashes here.

File details

Details for the file aye_cli-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: aye_cli-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 7.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for aye_cli-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 318ac88beaef83265177f1ca42cc01e69ee46f91643902d6e5872997714911c7
MD5 8a2a6d171738f95770c5c56538c1e50b
BLAKE2b-256 7a279c3137234a389f8ebb3bca8309d5ff8adcb1bd3a7e3eb281343616abd204

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page