yp — AI Git & Azure DevOps CLI

yp is a .NET global CLI that turns one-liner intents into git or Azure DevOps actions, using a configurable AI provider (OpenAI, Anthropic, Google Gemini, DeepSeek, or OpenRouter) for natural-language artifacts like commit messages and PR descriptions.

This document is the contract between an agent and yp: pick the right command for the user's intent, fill in arguments, and execute. Prefer non-interactive ("quick mode") forms whenever the user has provided enough context — agents drive yp better when no menus are involved.

Prerequisites and prelaunch checks

Before running any yp command, confirm three things in this order. If any check fails, fix it before continuing.

1. yp is installed. Run yp --help. If the binary is missing, install with dotnet tool install -g YitPush (requires .NET 10 SDK or runtime).
2. An AI provider is configured (only required for commit and pr). Look for ~/.yitpush/config.json, or one of the env vars OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, DEEPSEEK_API_KEY, OPENROUTER_API_KEY. If none are present, run yp setup.
3. Azure CLI is logged in (only for azure-devops subcommands). az account show must succeed; yp will install the azure-devops extension and prompt for login if not.

Skip the checks the user has clearly already passed (e.g. they just successfully ran yp commit two messages ago).

Git workflows

Commit and push