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.2.tar.gz (10.8 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.2-py3-none-any.whl (11.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aye_cli-0.1.2.tar.gz
  • Upload date:
  • Size: 10.8 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.2.tar.gz
Algorithm Hash digest
SHA256 3d7d92308854299fd49375294b4dc73b6fb562426550520bd42c1609a2b41d15
MD5 3ff6baac7d8b296a0c6edc7be66118bc
BLAKE2b-256 86db6ac8b32a0d5dad355216c748fb8c4af23abd6afbd3ded0292e9d7b9d7e9e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aye_cli-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 11.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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ebba70af8c6df0ea10e587a7a90cf0e4819e8a641092457fca31aca58b8f4ddc
MD5 467a83769818b43a8f1e10f1a9eaee98
BLAKE2b-256 6b5852536d2d52f7c4fe25978c4d694a94cb07a06de3b0bf46867e59216cbd26

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