push

A command-line workflow for sending your current Git branch to a shared Git repository and optionally opening a pull request, a request for teammates to review and merge your changes.

In plain words
What is it for?
Use it to push a branch, create regular or draft pull requests with titles and descriptions, safely force-push, or push several worktree branches at once.
Why use it?
It combines pushing code and preparing the review request, so you do not have to repeat those steps manually. It can also target a chosen base branch or create a draft for unfinished work.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/mirinodev/maestro/push
Clone the repo
git clone --depth 1 https://github.com/mirinodev/maestro
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,285 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.01285
Opus 5 $0.00000 $0.00642
Sonnet 5 $0.00000 $0.00257
Haiku 4.5 $0.00000 $0.00128

Measured yesterday against content hash 909e9d9ac310, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

push scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

docs/commands/push.md · 218 lines

How it starts

The opening of the file, as written. The whole thing — 218 lines — stays where its author put it; the contents beside it link to each section on GitHub.

🔸 push

Push current branch to remote repository and optionally create Pull Request. This command provides a streamlined workflow for completing development work and creating PRs.

Overview

mst push [options]

Usage Examples

Basic Usage

# Simple push to remote
mst push

# Push and create regular PR
mst push --pr

# Push and create Draft PR
mst push --draft-pr

Advanced Usage

# Push with custom PR details
mst push --pr --title "Add user authentication" --body "Implements login and signup features"

# Push to specific base branch
mst push --pr --base develop

# Force push (safely with --force-with-lease)
mst push --force

# Push all orchestra members with Draft PRs
mst push --all --draft-pr

# Skip PR template editing
mst push --pr --no-edit

Options

Option Description Default
--pr Create regular Pull Request false
--draft-pr Create Draft Pull Request false
--base <branch> Specify base branch for PR main
--title <title> Specify PR title branch name
--body <body> Specify PR body auto-generated
--no-edit Skip PR template editing false
--force Force push (uses --force-with-lease) false
--all Push all orchestra members false
--issue <number> Link to issue number none

Features

Smart Push Behavior

The push command intelligently handles different scenarios:

  1. First-time push: Automatically sets upstream with -u origin <branch>
  2. Existing branch: Simple push without upstream setting
  3. Force push: Uses --force-with-lease for safety

Read the full file on GitHub · 218 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 218 lines · 0 tokens per session scan A 909e9d9ac310

Subscribe to this mod's changes

push is a command published in the GitHub repository mirinodev/maestro (9 stars, last pushed 11mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,285 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.