yncli
A simple, fast AI coding assistant that lives in your terminal. It reads your project files, helps you plan features, and writes code directly to your disk so you don't have to copy-paste.
█ █ yncli 1.2.3
█ █ Autonomous AI Coding Agent
█ █ ag/claude-sonnet-4-6 (Build Mode)
█ ~/Projects/laravel-app
█
Project: PHP / Laravel (10/193 files in active memory)
build > @UserController.php add rate limiting to login endpoint
[ - ] Modifying app/Http/Controllers/UserController.php...
[OK] Applied changes & syntax check passed!
Quick Start
Run it instantly without installing anything:
npx @yanzyuyu/yncli
Or install it globally:
# Python
pip install yncli
# Node.js
npm install -g @yanzyuyu/yncli
Then just open any project folder and run:
yncli
Why use this?
Most AI tools spit out markdown blocks and expect you to copy-paste every file by hand. yncli works directly with your codebase:
- Zero-Setup Context: Automatically indexes your project files into memory so you never have to explain your directory structure.
- Plans Before It Codes (
/plan): Writes clear architecture specs and task lists intoplan.mdbefore making changes. - Direct File Edits (
/build): Modifies files directly on disk and runs syntax validation for PHP/Laravel, TypeScript, Python, Go, and more. - Bring Your Own Model: Use your Google Gemini key (
/google <key>), connect local Ollama (/endpoint http://localhost:11434/v1), or use OpenRouter/Groq. - Noise-Free Terminal: Pasting long error logs (100+ lines) collapses into
[ pasted 100 lines ]so your screen stays clean.
Usage
# Interactive coding session
yncli
# Quick one-liner fix
yncli "Fix broken migration in database/migrations"
# Start directly in planning mode
yncli --mode plan
Shortcuts
Inside the session:
| Command | Description |
|---|---|
@file |
Mention any file to inject its full content into context |
/model |
Open interactive model picker popup |
/google <key> |
Connect directly with your Google Gemini AI key |
/default |
Reset to default models (ag/*, cx/*) |
/endpoint <url> |
Connect to local Ollama, OpenRouter, or OpenAI |
/plan |
Plan architecture & save to plan.md |
/build |
Code & edit files autonomously |
/skills |
Switch persona (architect, debugger, ultrabrain) |
/update |
Auto-update yncli to latest release |
License
MIT © 2026 Yanzyuyu
1 maintainer
Metadata
1 maintainer
Release files for yncli 1.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yncli-1.5.1.tar.gz | 50.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yncli-1.5.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 109.9 kB
Release files / yncli-1.5.1.tar.gz
| Download URL | yncli-1.5.1.tar.gz |
|---|---|
| Size | 50.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
13f6e62be5d9f397a5115039fb7e90736a76ab8853779539a67dde92c3b603ed
|
|
BLAKE2b-256 checksum How to use checksums |
2c3a61421b01fa98210c9ca7a1ae64ff19b3a8108f4b1cd06979c20116f248a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / yncli-1.5.1-py3-none-any.whl
| Download URL | yncli-1.5.1-py3-none-any.whl |
|---|---|
| Size | 59.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d6aaf416e11e412f4ee053a76ee175001bb6a03944537f10f64c7a4799c9add6
|
|
BLAKE2b-256 checksum How to use checksums |
cd88a498a871db883f554b137f0a5f955397da4b222717950cc3b6e7a646c815
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
