ChatGPT in your shell, minus the context switching
A terminal assistant that turns plain English into shell commands so you don't have to memorize flags.

What it does
Yai sits in your terminal and translates natural language into executable commands via OpenAI’s API. Ask it to “find all PDFs modified last week” or “compress this folder with max compression” and it generates the shell incantation. It also answers general questions without making you open a browser.
The interesting bit
The tool auto-detects your OS, shell, username, and preferred editor to ground its responses in your actual environment. That context — plus any custom preferences you add — means “open my config” resolves to nvim ~/.config/nvim/init.lua or code ~/.config/Code/User/settings.json depending on who’s asking.
Key highlights
- Built with Bubble Tea, the Go TUI framework from Charm — so the interface is actually pleasant
- One-liner install via curl + bash, then prompts for your OpenAI API key on first run
- Configuration lives in
~/.config/yai.json; documented at a separate GitHub Pages site - Supports GPT-3 and GPT-4 per the repo topics (the README itself just says “ChatGPT”)
Caveats
- Requires an OpenAI API key; no local or alternative model support is mentioned
- The README’s “unleash the power of artificial intelligence” line is doing a lot of heavy lifting — the actual feature set is fairly standard for this genre
Verdict
Worth a look if you live in the terminal and already pay for OpenAI API access. Skip it if you want offline operation, distrust sending shell context to a third party, or already have a shell workflow you can run blindfolded.
Frequently asked
- What is ekkinox/yai?
- A terminal assistant that turns plain English into shell commands so you don't have to memorize flags.
- Is yai open source?
- Yes — ekkinox/yai is open source, released under the MIT license.
- What language is yai written in?
- ekkinox/yai is primarily written in Go.
- How popular is yai?
- ekkinox/yai has 867 stars on GitHub.
- Where can I find yai?
- ekkinox/yai is on GitHub at https://github.com/ekkinox/yai.