Troubleshooting

Troubleshooting

Command not found

If the terminal cannot find yoo, restart the terminal after installation.

Check whether it is available:

Windows

Get-Command yoo

Linux or macOS

command -v yoo

Also make sure your package manager's binary directory is included in PATH.

Missing configuration warning

Create the default configuration:

yoo init

A configuration file is optional. The built-in defaults work without one.

Print the expected configuration path:

yoo config

Missing Git information

Make sure:

• You are running yoo inside a Git repository.
• Git is installed.
• The git command is available in PATH.

Check Git with:

git --version
git status

Project is not detected

Run yoo from the project root containing files such as:

• Cargo.toml
• package.json
• pyproject.toml
• go.mod
• pom.xml
• .sln or .csproj

Then run:

yoo project

No colours

Colour is automatically disabled when appropriate. If output is redirected, use plain output explicitly:

yoo --plain

Otherwise, use a terminal with ANSI colour support.

Cargo installation is slow

cargo install yoo compiles the project locally.

Use Cargo Binstall for a prebuilt binary:

cargo binstall yoo

JSON rejects an option

JSON output cannot be combined with display options.

This is invalid:

yoo project --json --plain

Use:

yoo project --json

Check the complete setup

yoo doctor

Still having trouble?

Open an issue and include:

• Operating system
• Installation method
• Output from yoo --version
• Output from yoo doctor
• The exact command and error message

Open a GitHub issue