Skip to content

Home

Jump to bottom
nihitdev edited this page Jul 30, 2026 · 7 revisions

yoo Wiki

yoo is a small, local-first CLI for viewing project, Git, and development environment information.

It is written in Rust and works on Windows, Linux, and macOS.

Documentation

Quick start

yoo --fast
yoo doctor
yoo project

No configuration is required for normal use.

Links

Privacy

yoo only reads local environment, project, and Git information. It has no telemetry, accounts, daemon, or external AI service.

Installation

Choose one installation method. You do not need to install yoo more than once.

WinGet

Windows users can install yoo with WinGet:

winget source update
winget install --id Nihitdev.yoo --exact

Upgrade it later with:

winget upgrade --id Nihitdev.yoo --exact

Cargo Binstall

Install a prebuilt binary:

cargo binstall yoo

If Cargo Binstall is unavailable:

cargo install cargo-binstall
cargo binstall yoo

Cargo

Build and install from crates.io:

cargo install yoo

npm

npm install --global @nihitde_v/yoo

pnpm

pnpm add --global @nihitde_v/yoo

Bun

bun add --global @nihitde_v/yoo

The npm, pnpm, and Bun packages download the matching prebuilt binary from GitHub Releases.

Scoop

scoop bucket add nihitdev https://github.com/nihitdev/scoop-bucket
scoop install yoo

Arch Linux

Using an AUR helper:

yay -S yoo-bin

Build from source

Rust 1.85 or newer is required:

git clone https://github.com/nihitdev/yo-cli.git
cd yo-cli
cargo install --path .

Verify the installation

yoo --version
yoo doctor

If yoo is not recognized after installation, restart the terminal and check the Troubleshooting page.

Page: Usage

Usage

Run yoo inside a project directory:

yoo

For faster output without the typing animation:

yoo --fast

Commands

Command Description
yoo Start a developer session
yoo doctor Check local tools, configuration, project detection, and Git
yoo project Show project metadata, source statistics, and Git details
yoo fetch Show the development environment and current project
yoo status Alias for yoo fetch
yoo session [MINUTES] Start a local focus timer
yoo tip [PACK] Print a random tip
yoo tips List available tip packs
yoo init Create the default configuration and sample tip pack
yoo config Print the active configuration path
yoo version Print the installed version
yoo help Show the complete help message

Display options

yoo --fast
yoo --no-art
yoo --plain
yoo --name YourName
yoo --theme tokyo-night

Available themes:

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

Inspect a project

cd path/to/project
yoo project

This displays information such as:

  • Project name and language
  • Project version
  • Package manager
  • Source-file statistics
  • Git branch and working-tree status
  • Common repository files

Check the development environment

yoo doctor

This checks Rust, Cargo, Git, Rustfmt, Clippy, configuration, project detection, and repository state.

JSON output

Use JSON output in scripts and editor integrations:

yoo fetch --json
yoo project --json

--json cannot be combined with display options such as --plain, --no-art, or --theme.

Focus timer

Start the configured default timer:

yoo session

Start a 45-minute timer:

yoo session 45

The alternative syntax is:

yoo session --minutes 45

Tips

Print a tip from the configured pack:

yoo tip

Select a specific pack:

yoo tip rust

List all available packs:

yoo tips

Built-in packs include general, git, linux, and rust.

Configuration

Create the default configuration:

yoo init

Print its location:

yoo config

Configuration locations:

Windows: %APPDATA%\yoo\config.yaml
Linux:   ~/.config/yoo/config.yaml
macOS:   ~/Library/Application Support/yoo/config.yaml

Clone this wiki locally