YitPush 2.0.0

🚀 yp (YitPush)

AI-Powered Git Commit and Azure DevOps Management Tool — now with multi-provider AI support.

🛠️ Installation

# Clone the repository
git clone https://github.com/elvisbrevi/yitpush.git
cd yitpush

# Build and install globally
dotnet pack -c Release
dotnet tool install --global --add-source ./nupkg YitPush

Note: The command is yp. If you've previously installed it as yitpush, uninstall it first: dotnet tool uninstall -g YitPush.

After installing, run yp setup to configure your AI provider. The setup wizard will also offer to add the yitpush alias to your shell automatically (.zshrc, .bashrc, or .profile depending on your OS).

Install as an Agent Skill

If you use Claude Code, Cursor, Gemini CLI, or any Agent Skills-compatible agent, install the yp skill so your agent knows how to use it automatically.

Via yp (recommended — also offered during yp setup):

yp skill

Or directly with the skills CLI:

npx skills add elvisbrevi/yitpush

Listed on skills.sh/elvisbrevi/yitpush.

🔑 Configuration

Interactive Setup (Recommended)

Run the setup wizard to configure your preferred AI provider:

yp setup

The wizard will guide you through:

1. Selecting a provider: OpenAI, Anthropic, Google Gemini, DeepSeek, or OpenRouter
2. Entering your API key (masked input)
3. Selecting a model from a curated list or entering a custom one
4. Validating the key with a test call
5. Saving to ~/.yitpush/config.json

Manual / Environment Variable (Backward Compatible)

You can still use environment variables. If no config file is found, DEEPSEEK_API_KEY is used automatically:

export DEEPSEEK_API_KEY='your-api-key-here'

Other supported environment variables (override the config file):

export OPENAI_API_KEY='...'
export ANTHROPIC_API_KEY='...'
export GOOGLE_API_KEY='...'
export DEEPSEEK_API_KEY='...'
export OPENROUTER_API_KEY='...'

📖 Usage

Git Commands

Azure DevOps Commands

🚀 Detailed Features

🤖 Multi-Provider AI Support

yp supports five AI providers. Run yp setup to switch between them at any time.

📝 Smart Commits

yp commit analyzes your staged changes and generates a professional commit message.

yp commit                          # Auto commit and push
yp commit --confirm                # Review before committing
yp commit --detailed               # Generate title + body
yp commit --language spanish       # Output in Spanish
yp commit -l french                # Short flag for language

📋 Pull Request Descriptions

yp pr interactively selects two branches and generates a ready-to-paste PR description.

yp pr                              # Generate PR description
yp pr --detailed                   # Detailed with testing notes
yp pr --language spanish           # Output in Spanish
yp pr -l french                    # Short flag for language
yp pr --save                       # Save to markdown file

🔷 Azure DevOps Integration

📋 Task Management

• List & Update: Use yp azure-devops hu list to see all tasks of a HU. Select a task to:
  • View full Description.
  • See Effort (HH), Esfuerzo Real (HH) and Remaining Work.
  • Inspect Links (Branches, Commits, PRs).
  • Update fields interactively.

⚡ Quick Mode (CLI)

Update work items directly from your terminal:

# Update multiple fields
yp azure-devops task update <org> <id> --state "Active" --effort-real "5" --remaining "2"

# Add a comment
yp azure-devops task update <org> <id> --comment "Progress update: logic refactored"

# Create tasks with info
yp azure-devops hu task <org> <proj> <hu-id> --description "Task info" --effort "4"

🔗 Deep Linking

Link your local branch to an Azure DevOps work item natively:

yp azure-devops hu link <org> <proj> <id> --repo <name> --branch <name>

This uses ArtifactLink, making the branch appear in the Development section of the Azure Boards UI.

📝 Navigation

• Every interactive menu includes a ← Back option.
• All lists (HUs, Tasks, Projects, Repos) are sorted by Recency First (ID Descending).
• Auto-detection: The tool automatically detects your organizations and projects.

Created with ❤️ by Elvis Brevi