This release is a pre-release and may not be stable for production use.
Aye Chat: AI-powered shell for Linux
An AI assistant integrated into your shell: execute commands, edit files, and prompt AI, all in one seamless session.
Key Features
- 🚀 Seamless Shell Integration - Your shell, super-powered. Run
ls,git, and evenvimin the same session you chat with AI. No prefixes, no context switching. - 🧠 Zero-Config Context - Aye Chat automatically detects your project's files, respecting your
.gitignore, so you can start coding immediately. - ✍️ Direct File Editing - The AI directly edits and creates files in your project. No more copy-pasting code from a chat window.
- ⏪ Instant Undo - AI made a mistake? A single
restorecommand instantly reverts the last set of changes. Your work is always safe. - 🖥️ Terminal-Native Experience - A rich, responsive UI built for developers who live in the command line.
- 🧩 Extensible via Plugins - The core experience is enhanced by plugins for shell execution, autocompletion, and more.
Quick Start
-
Install the tool:
pip install ayechat
-
Start interactive chat in your source code folder:
aye chat -
Start talking to your shell. That's it!
Core Commands
Authentication
aye auth login # Configure your access token
aye auth logout # Remove stored credentials
Starting a Session
aye chat # Start chat with auto-detected files
aye chat --root ./src # Specify a different project root
aye chat --include "*.js,*.css" # Manually specify which files to include
In-Chat Commands
In chat mode, your input is handled in a specific order:
- Built-in Commands (like
restoreormodel). - Shell Commands (like
ls -laorgit status). - AI Prompt (everything else is sent to the LLM).
Session & Model Control
new- Start a fresh chat session.model- Select a different AI model.verbose [on|off]- Toggle printing the list of files sent to the AI.exit,quit,Ctrl+D- Exit the chat.help- Show available commands.
Reviewing & Undoing AI Changes
restore- Instantly undo the last set of changes made by the AI.history- Show the history of changes made by the AI.diff <file>- Compare the current version of a file against the last change.
Shell Commands Any command that is not a built-in is treated as a shell command.
- You can run standard commands like
ls -la,git status, ordocker ps. - Interactive commands like
vim,nano, andlesswork seamlessly, handing control over to the editor and returning you to the chat when you're done.
Philosophy
Aye Chat reimagines coding as a fluid conversation with an AI-powered shell.
Built for the terminal, it trusts the AI to act directly on your files—no approval diffs, no friction. This high-velocity workflow is made safe by a simple, instant undo command that keeps you in complete control.
By removing the barriers between thought, command, and code, Aye Chat lets you build software at the speed of your ideas.
Configuration & Privacy
- Aye Chat respects
.gitignoreand.ayeignore—your private files are never touched. - Change history and backups are stored locally in the
.aye/folder within your project.
🤝 Contributing
Aye Chat is open-source — we welcome contributions!
- Fork the repo and submit PRs.
- Open issues for bugs or ideas.
- Join our discussions on our Discord Server.
🔥 Ready to code with AI — without leaving your terminal?
Metadata
Release files for ayechat 0.21.2.dev20251108131521
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ayechat-0.21.2.dev20251108131521.tar.gz | 452.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ayechat-0.21.2.dev20251108131521-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 496.0 kB
Release files / ayechat-0.21.2.dev20251108131521.tar.gz
| Download URL | ayechat-0.21.2.dev20251108131521.tar.gz |
|---|---|
| Size | 452.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5a6dd2a4b7ac0041644dbb75d2c4cd2773c31af34b3cd5f59f5a62c9aab35fc1
|
|
BLAKE2b-256 checksum How to use checksums |
6b7a0795a18eaa156fde2064ed6517d0d01db6075dfd17dd324a6a81e9ef95ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 8, 2025.
Transparency logRelease files / ayechat-0.21.2.dev20251108131521-py3-none-any.whl
| Download URL | ayechat-0.21.2.dev20251108131521-py3-none-any.whl |
|---|---|
| Size | 44.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cfee63caa6ae99e874ed590710b837a7369897f53796ff0740331a80d6ff5dfe
|
|
BLAKE2b-256 checksum How to use checksums |
4038f58eb70180c9e82554ceaaf99ccb9c9b3a65e32eaa75a28f6005eca72463
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 8, 2025.
Transparency log
