PLEASE

PLEASE CLI

PLEASE is a command-line interface designed to eliminate Git friction. You never type complex raw Git commands or struggle with commit messages again. Run please commands instead, and an AI agent handles staging, commit message generation, and branch operations on your behalf.

Key Features

🤖 AI-Powered Commits

Run please commit to inspect modified files, split changes into logical units, and generate clean, standardized commit messages automatically.

💬 Agent Mode

Run please followed by any plain-language request in quotes (e.g., please "sync with main and resolve conflicts"). The AI agent formulates an execution plan and safely executes commands through Git and GH CLI.

🛡️ Built-in Safety Nets

Destructive operations (force push, hard reset, branch deletion) require explicit confirmation up front. Sensitive environment files (.env, secrets) are protected from accidental commits.

🔌 Choice of AI Provider

Connect to your preferred AI model—Anthropic Claude, Google Gemini, or OpenAI ChatGPT. Switch providers anytime without losing saved keys.

Command Quick Reference

CommandAction
please commitAnalyze diffs, stage files, and generate commit messages
please pushCommit staged work and push the current branch to origin
please reviewAI review of the current changes, with suggested tests
please runFigure out how to run this project, then remember it
please statusView branch status and changes explained in plain language
please doctorDiagnose Git, repository, and AI provider health
please branchCreate, switch, rename, or clean up branches
please syncRebase or merge current branch with main safely
please undoRevert recent commits or restore previous working state
please squashCombine a run of commits into one, AI-written message
please updateUpdate please itself to the latest release

Getting Started

  1. Install PLEASE: See the Installation Guide to install a prebuilt binary with a script, Homebrew, or a direct download, or build it from source.

  2. Connect your Provider: Run please setup to configure your API key.

  3. Read Documentation: Explore the full Command Reference to master PLEASE.

Next
Page not found