Skip to main content

Aye: AI‑powered coding assistant for the terminal

Project description

aye

Aye: AI‑powered coding assistant for the terminal

Aye is a 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.1.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.1-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aye_cli-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 228d3586d5c63c5f9f8d0852517cc8003c8e947302a981a1bf3a169d46154f51
MD5 093a0e30e01ddd829eefe6fe460caeca
BLAKE2b-256 2e9dbc214d33b2cc9af0600743229d8eb4831aee2f2f61d99be71a05ec63714e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aye_cli-0.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 dc8eaf9a412d4a7144b445f3e5ef6f465dc4aff2c35c1662272180fd9c37bc30
MD5 5ec2a5a08f5ce902858b25ac5de7eb89
BLAKE2b-256 5b7bbec386aa1369eebf2b8d79fee303391a4c2de1dcac7c6361d8619c28afbc

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