Yai — ChatGPT for Your Terminal That Understands Context
Familiar situation: you're sitting at the terminal, need to execute a complex command, but forgot the exact syntax? Or maybe you want to quickly get an answer to a technical question without opening a browser? The Yai project solves exactly these problems, bringing the power of ChatGPT right into your terminal.
What is Yai?
Yai (your AI) is a terminal assistant based on OpenAI's ChatGPT that:
- Converts your natural language descriptions into working commands
- Answers questions without leaving the terminal
- Takes into account your system context (OS, shell, username)
- Allows you to customize behavior to suit your needs

Why is this convenient?
Instead of:
- Googling the command syntax
- Copying from Stack Overflow
- Adapting it to your system
- Testing on sample data
You simply write something like:
yai "найди все файлы .log старше 30 дней и сожми их в архив"
And get a ready-to-use command with an explanation that you can execute immediately.
5 reasons to try Yai
- Time savings — no longer need to memorize hundreds of flags for grep, awk, and other utilities
- Context awareness — Yai knows your OS, shell, and environment
- Interactivity — you can refine and correct commands in a dialogue
- Versatility — answers general questions too, not just about commands
- Easy installation — one curl request and you're ready to go
How does it work technically?
Yai is written in Go and uses:
- OpenAI API for natural language processing
- Bubble Tea library for a beautiful TUI interface
- Configuration file for storing personal settings
The project is actively developing — over 800 stars on GitHub and regular updates.
Practical usage examples
- Server administration
yai "покажи нагрузку на CPU с сортировкой по процессам"
- Data processing
yai "отфильтруй CSV файл, оставив строки где вторая колонка больше 100"
- Programming
yai "как в Python проверить что строка содержит только цифры?"
- Personal settings You can specify your preferred editor, favorite flags, and other preferences.
How to get started?
Installation takes a minute:
curl -sS https://raw.githubusercontent.com/ekkinox/yai/main/install.sh | bash
On first launch, you'll need an OpenAI API key. All settings are saved to ~/.config/yai.json.
Who will find it especially useful?
- System administrators
- DevOps engineers
- Developers working with the terminal
- Anyone tired of googling command syntax
Yai is not just a pretty wrapper for ChatGPT. It's a tool that actually saves time, reduces context switching, and makes working in the terminal more enjoyable. If you spend more than an hour a day in the command line — it's worth trying.
Full documentation: https://ekkinox.github.io/yai/
Related projects