push

A command that pushes committed code to a remote Git repository after running the project's pre-push checks.

In plain words
What is it for?
Use it to verify platform checks, checksums, generated files, and schema synchronization before publishing the current branch.
Why use it?
It prevents common validation failures from reaching the remote repository and stops when uncommitted work could be affected.

Command for Claude Code

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/sanmak/specops/push
Clone the repo
git clone --depth 1 https://github.com/sanmak/specops

Made for: Claude Code.

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 554 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.00554
Opus 5 $0.00000 $0.00277
Sonnet 5 $0.00000 $0.00111
Haiku 4.5 $0.00000 $0.00055

Measured yesterday against content hash 22b144da2557, 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.

.claude/commands/push.md · 59 lines

How it starts

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

Push the current branch to remote after validating all pre-push checks pass.

Instructions

Follow these steps precisely.

Step 1: Check current state

Run git status to confirm the working tree. If there are uncommitted changes (modified or untracked files), warn the user: "There are uncommitted changes. Run /commit first or commit manually before pushing." and stop.

Step 2: Check if there is anything to push

Run git log @{upstream}..HEAD --oneline 2>/dev/null to see unpushed commits.

If the command fails (no upstream set), note that we will push with -u to set upstream tracking.

If there are no unpushed commits and upstream exists, inform the user "Already up to date with remote -- nothing to push" and stop.

Step 3: Run pre-push validation

Before pushing, proactively run the same checks the pre-push hook will run, so we can fix issues before they block the push:

  1. python3 generator/validate.py -- platform validation
  2. shasum -a 256 -c CHECKSUMS.sha256 -- checksum verification
  3. python3 generator/generate.py --all && git diff --exit-code platforms/ skills/ .claude-plugin/ -- generated files freshness
  4. python3 tests/check_schema_sync.py -- schema structure
  5. bash scripts/run-tests.sh -- full test suite
  6. npx markdownlint-cli2 "core/**/*.md" "docs/**/*.md" ".claude/commands/**/*.md" "README.md" "CLAUDE.md" "QUICKSTART.md" "CONTRIBUTING.md" "CHANGELOG.md" -- markdown lint (skip if npx not available)

If any check fails:

  • Report which check failed and the error output
  • If the failure is fixable (stale generated files, stale checksums), explain what the user needs to do
  • Do NOT push. Stop and let the user fix the issue.

Step 4: Push

Determine the current branch: git rev-parse --abbrev-ref HEAD

If the branch has an upstream, run:

git push

If the branch does not have an upstream, run:

git push -u origin <branch-name>

Do NOT use --no-verify -- let the pre-push hook run normally.

If the push fails, report the error to the user.

Read the full file on GitHub · 59 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 · 59 lines · 0 tokens per session scan A 22b144da2557

Subscribe to this mod's changes

push is a command published in the GitHub repository sanmak/specops (49 stars, last pushed 29d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 554 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-30.