Aye: Terminal-first AI Code Generator
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ayechat-0.1.5.tar.gz
(21.6 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
ayechat-0.1.5-py3-none-any.whl
(24.2 kB
view details)
File details
Details for the file ayechat-0.1.5.tar.gz.
File metadata
- Download URL: ayechat-0.1.5.tar.gz
- Upload date:
- Size: 21.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0c1f0f6cdcc95ca81a7d24e02f9978c539b54c440bfe8c250744514499fee296
|
|
| MD5 |
1f06e7c994229965d8bfea6c1e6795c0
|
|
| BLAKE2b-256 |
47d39f6c06734063b436eb64063e4448157333c8a596b80bb81934c2e90613df
|
File details
Details for the file ayechat-0.1.5-py3-none-any.whl.
File metadata
- Download URL: ayechat-0.1.5-py3-none-any.whl
- Upload date:
- Size: 24.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5697cb097f70d81b5ceb0dc4af0013a6d58ff0784cedb3c9e31ab96941553639
|
|
| MD5 |
ba367f51205a07bf530d009855ed667b
|
|
| BLAKE2b-256 |
8ff2c8a6cd3d68b3f039cffac515ed96b95f3699fe98f8b1869bbf4a0040391d
|