Commands

Full command reference, grouped by what you are trying to do.

Reference table

Command	What it does	Destructive
`please init`	Initializes a git repo here, and generates please.md	No
`please clone <url>`	Clones a remote repository, plain `git clone`	No
`please github [url]`	Initializes, commits, and publishes a project to GitHub	No
`please change origin <url>`	Moves the repository to another remote	No
`please change origin and push <url>`	Moves to another remote and republishes all history	No
`please commit`	Stages changes and writes commits with the AI	No
`please push`	Runs commit, then pushes to origin	No
`please review`	AI review of the current changes, with suggested tests	No
`please run`	Figures out how to run this project, then remembers it	No
`please run set "<cmd>"`	Records how to run the project by hand, no AI	No
`please run reset`	Clears the saved run decision	No
`please status`	Plain language view of where you stand	No
`please doctor`	Diagnoses Git, repository, and AI provider health	No
`please branch [name]`	Lists branches, or creates and switches to one	No
`please switch <name>`	Switches to an existing branch	No
`please start "purpose"`	Creates a purpose-named feature branch	No
`please sync`	Fetches and merges the upstream branch	No
`please sync exactly`	Makes the local branch match the remote exactly	Yes
`please undo`	Undoes the last commit, keeps the changes	No
`please redo`	Brings back the last undo	No
`please recover [n]`	Recovers a recent commit onto a new branch	No
`please recover changes`	Restores the safety stash from `please discard`	No
`please context [--refresh]`	Inspects or regenerates the cached project context	No
`please move-commit <branch>`	Moves the last commit onto a new branch	No
`please discard`	Throws away all uncommitted changes	Yes
`please restore <path>`	Brings back a file deleted in a past commit	No
`please branch delete <name>`	Deletes a branch locally and on origin	Yes
`please rename <new-name>`	Renames the current branch, including on the remote	No
`please cleanup`	Deletes local branches already merged into main	No
`please log`	A readable commit graph	No
`please revert`	Interactive revert of a past commit	No
`please resolve`	Explains and helps resolve merge conflicts with AI	No
`please stash`	Saves and clears the working tree	No
`please stash list`	Shows saved stashes	No
`please stash pop`	Restores the most recent stash	No
`please stash drop`	Deletes the most recent stash	Yes
`please squash [n \| ref]`	Combines a run of commits into one, AI-written message	Only if already pushed
`please split`	Splits the working tree into logical commits with AI	No
`please reorder`	Reorders recent commits with AI	No
`please combine`	Merges commits together with AI	No
`please release`	Drafts release notes and a version from recent commits	No
`please purge <path>`	Permanently removes a file or folder from all git history	Yes
`please config`	Interactive menu to set persistent preferences	No
`please "..."`	Agent mode, a plain language request	Varies
`please chat`	The agent, kept alive across multiple messages	Varies
`please alias <name>`	Gives please a shorter command name	No
`please update`	Updates please itself to the latest release	No