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.4.tar.gz (16.1 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.4-py3-none-any.whl (18.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aye_cli-0.1.4.tar.gz
  • Upload date:
  • Size: 16.1 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.4.tar.gz
Algorithm Hash digest
SHA256 e79c667532edc6af5f8ec07e232ff7f7ac562284e74985388cf10a8dbdc75b0e
MD5 7ae3eda3847a9c44cf8f85373d3b02f3
BLAKE2b-256 d1ef8c2b1f370f853137b122f702c6b766bcf95de32e20c46ae68c355fd29d07

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aye_cli-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 18.0 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 71a5dc9dcb24ef1f62001f7aacb666d014ee99d8645a3a7dc3407e6fe4f4c10e
MD5 0c3f663d7060315954efd0c9d2277091
BLAKE2b-256 8a0db1b010ea14a4a645d35fee3b860ad948b9612c9fed723704f5b1ed7dd749

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