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 into plan.md before 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

Metadata

Release files for yncli 1.5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for yncli 1.5.2
File	Size	Uploaded
yncli-1.5.2.tar.gz	50.9 kB	Sep 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for yncli 1.5.2
File	Interpreter	ABI	Platform	Reset
yncli-1.5.2-py3-none-any.whl 59.3 kB Sep 22, 2026	Python 3	none	any	Details

Total release size: 110.2 kB

Release files / yncli-1.5.2.tar.gz

Download URL	yncli-1.5.2.tar.gz
Size	50.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`b4516b3d466ef2012407e417c1e91543c8f0481a81687c067ad6e18dccc7d534`
BLAKE2b-256 checksum How to use checksums	`a05d208bd0c644ad90589326e38add8b9e72082e43b84d801a660d2d7e0bb7c3`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.15`

Release files / yncli-1.5.2-py3-none-any.whl

Download URL	yncli-1.5.2-py3-none-any.whl
Size	59.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9c0418511f039904bb7bd61e0a95ab4440750a77e38a9198f803c5e636625200`
BLAKE2b-256 checksum How to use checksums	`5ff4bc5862a74a4aa4bee0153798a5475f5366acb1c07419305e2915b3cc62d1`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.15`