What the hell is going on with this project?
Your project, Git state, and dev tools — one command away.

Website · Quick start · Docs · Releases

---

Your terminal, with context

Built in Rust. Runs on Linux, macOS, and Windows. No account, daemon, telemetry, or AI service. Your project data stays on your machine.

Know where you are	Know what changed	Know what’s missing
Project type, package manager, source counts, and metadata.	Branch, pending changes, conflicts, and local snapshots.	Toolchain checks that follow the project you’re in.
yoo project	yoo snapshot compare --current	yoo doctor

Quick start

cargo install yoo
cd your-project
yoo --fast

No Rust installed? Use npm:

npm install -g @nihit_dev/yoo

Install

Pick the method that matches your system. The first three are the quickest for most developers.

1. Cargo — build and install from crates.io (Linux, macOS, Windows): cargo install yoo

2. Cargo Binstall — download a prebuilt release binary: cargo binstall yoo

3. Arch Linux — install the AUR package: yay -S yoo-bin (or paru -S yoo-bin)

4. Homebrew — macOS or Linux: brew tap nihitdev/tap && brew install yoo

5. WinGet — Windows: winget install --id Nihitdev.yoo --exact

6. Chocolatey — Windows: choco install yoo

7. npm — npm install -g @nihit_dev/yoo (also available through pnpm and Bun):

   pnpm add -g @nihit_dev/yoo
   bun add -g @nihit_dev/yoo

8. Nix — run without installing: nix run github:nihitdev/yo-cli

9. Verified installer — Linux x86-64 and Apple Silicon macOS; verifies the downloaded binary:

   curl --proto '=https' --tlsv1.2 -LsSf https://yo-cli.vercel.app/yo-setup | sh

10. APT — Debian and Ubuntu:

curl -fsSL https://yo-cli.vercel.app/apt/setup.sh | sudo sh
sudo apt install yoo

11. DNF — Fedora and RHEL:

sudo dnf config-manager addrepo --from-repofile=https://yo-cli.vercel.app/rpm/yoo.repo
sudo dnf install yoo

12. Alpine Linux — add https://yo-cli.vercel.app/alpine to /etc/apk/repositories, then run sudo apk add yoo.
13. openSUSE Tumbleweed — sudo zypper ar -f https://yo-cli.vercel.app/opensuse yoo && sudo zypper refresh && sudo zypper install yoo
14. Flatpak — add the yoo repository, then install the app:

flatpak remote-add --user yoo https://yo-cli.vercel.app/flatpak/yoo.flatpakrepo
flatpak install --user yoo io.github.nihitdev.yoo

Release packages (.deb, .rpm, .apk, and .xbps) are also available from GitHub Releases. Snap artifacts are attached there too; Snap Store publishing is disabled. Installation details, checksums, updates, and removal steps are in the installation guide.

Commands

Start here. Run commands from the directory you want to inspect.

I want to…	Run
Get oriented	yoo --fast
Inspect the project	yoo project
Check my dev setup	yoo doctor
See my environment	yoo fetch
Save a point in time	yoo snapshot
Compare it with now	yoo snapshot compare --current
Start a focused session	yoo session 25
Open my editor	yoo edit
Feed a script	yoo project --json

Full command reference → — flags, snapshot IDs, tips, completions, JSON, and exit codes.

See project reports and toolchain checks

Project overview

Doctor

Project detection

13 project types. Matching tool checks. Source counts that respect ignore rules.

🦀 Rust	⚡ Zig	🟨 Node.js	🐍 Python
🐹 Go	☕ Java	💎 Ruby	🐘 PHP
🐦 Swift	🎯 Dart	💧 Elixir	⚙️ C/C++
🟣 .NET

Detection uses manifests in the current directory. C/C++ detection uses CMake; Dart includes Flutter projects. In mixed projects, the first matching manifest wins.

Markers, precedence, and source-count rules →

Configuration

yoo init                         # Create your config
yoo config                       # Print its location
yoo --fast --theme catppuccin     # Try a theme

Nine themes, your editor, your pace

neon · ocean · mono · dracula · tokyo-night · gruvbox · nord · rose-pine · catppuccin

[appearance]
theme = "catppuccin"
ascii = true
colors = true

[editor]
command = "code"

[session]
default_minutes = 25

Choose a theme, tune the timer, hide the ASCII art, or add your own YAML tip packs.

Configuration guide · Full example · Shell completions

Troubleshooting

Run yoo doctor for local diagnostics and yoo config to find your configuration. Installation help · Git errors and exit codes · Report an issue

Build from source

Requires Rust 1.85 or newer. Node.js is only needed for the website and npm wrapper.

git clone https://github.com/nihitdev/yo-cli.git
cd yo-cli
cargo build --release --locked
cargo test --locked

Check your installed version with yoo --version:

yoo 1.1.2

Contributing · Release guide · Packaging

---

Made for the moment you open a repo and wonder where to start.

Contribute · Changelog · Security · GPL-3.0-or-later