Open source · GPL-3.0-or-later

Project context,
without leaving the terminal.

A local-first CLI for project metadata, Git status, development environment checks, session timers, and configurable reminders.

Install yooLatest release ↗
RustWindowsLinuxmacOSNo telemetry
~/projects/yoov1.0.0
yoo displaying a terminal project session summary

What yoo does

Your project's vital signs, at a glance.

Use one focused tool instead of stitching together a handful of commands whenever you enter a repository.

01

Know the repository

See the detected language, version, package manager, source-file counts, branch, and working-tree state in one scan.

$ yoo project
02

Check the toolchain

Confirm that Git, language tools, formatters, linters, project detection, and your yoo configuration are ready to use.

$ yoo doctor
03

Start with context

Open a coding session with the project name, branch, pending changes, and one useful reminder already in view.

$ yoo --fast
04

Automate the output

Use stable, undecorated JSON in scripts, editor integrations, status bars, and your own developer tooling.

$ yoo project --json

Terminal output

One command for each view.

Every report stays local. JSON output is available for scripts and editor integrations.

Session summary$ yoo --fast
Session summary shown in the yoo terminal interface
Toolchain checks$ yoo doctor
Toolchain checks shown in the yoo terminal interface
Project overview$ yoo project
Project overview shown in the yoo terminal interface
Environment report$ yoo fetch
Environment report shown in the yoo terminal interface
Session timer$ yoo session 25
Session timer shown in the yoo terminal interface
Tip packs$ yoo tips
Tip packs shown in the yoo terminal interface
Editor launch$ yoo edit
Editor launch shown in the yoo terminal interface

Installation

Use the package manager already on your system.

Installercurl --proto '=https' --tlsv1.2 -LsSf https://yo-cli.vercel.app/yo-setup | sh
Cargocargo install yoo
npmnpm install -g @nihitde_v/yoo
WinGetwinget install --id Nihitdev.yoo --exact
Scoopscoop bucket add nihitdev https://github.com/nihitdev/scoop-bucket scoop install yoo

Command reference

Small command surface. Plain output.

yooCurrent project, Git state, and one configured reminder
yoo doctorLocal toolchain and repository checks
yoo editOpen the current project in your preferred editor
yoo projectProject metadata, source statistics, and Git details
yoo fetchDevelopment environment and current project
yoo session 25Local coding-session timer
yoo completions bashGenerate completions for your shell
More built in

yoo status, yoo tip, yoo tips, yoo init, yoo config, and yoo help.

Full command reference →

Project detection

Useful across your whole projects folder.

yoo recognizes common repository markers and package managers automatically. Generated folders and dependencies are skipped while source files are counted.

ProjectDetected fromPackage tooling
RustCargo.tomlCargo
Node.jspackage.jsonnpm · pnpm · Yarn · Bun
Pythonpyproject.tomlpip · uv · Poetry · Pipenv
Gogo.modGo modules
Javapom.xml · GradleMaven · Gradle
.NET.sln · .csproj.NET SDK

Made for automation

Human-friendly in a terminal. Predictable in a script.

Switch project and environment reports to JSON when another tool needs the data. Decorative display flags stay separate, so machine-readable output remains clean.

yoo fetch --jsonyoo project --json
{
  "yoo_version": "1.0.0",
  "project": {
    "name": "yoo",
    "language": "Rust",
    "version": "1.0.0"
  },
  "git": {
    "branch": "main",
    "changed_files": 0
  }
}

Make it yours

Configure once. Stay local.

Run yoo init to create a readable TOML config and a sample tip pack. Choose a theme, tune the session timer, hide ASCII art, or add reminders for your own team.

config.toml~/.config/yoo
[appearance]
theme = "catppuccin"
ascii = true
colors = true

[editor]
command = "code"

[git]
show_branch = true
show_status = true

[session]
default_minutes = 25
09 themes included

Match your terminal.

Neon, Ocean, Mono, Dracula, Tokyo Night, Gruvbox, Nord, Rosé Pine, and Catppuccin ship with yoo.

Configuration guide →

Project principles

Local by design.

yoo reads local project, environment, and Git information and prints it to your terminal. It does not transmit or retain project data.

Contributing guide →
00Network calls during normal use
00Accounts or required services
01Small Rust executable
09Built-in color themes

Ready when you are

Meet the project you're in.

Install yoo, open a repository, and run your first local project summary.

Choose an install methodRead the docs ↗