Ship

/meridian:ship — Commit + Push + PR

Ship completed work: commit staged changes, push to remote, create PR.

Arguments

• --commit-only — Just commit, don't push or create PR
• --push-only — Push existing commits, create PR
• --no-pr — Push without creating PR
• --branch — Override branch name

Procedure

Step 1: Check Git State

git status
git diff --stat
git log --oneline -5

Step 2: Verify Tests Pass

Run the project's test suite before shipping:

# Detect and run appropriate test command
uv run pytest tests/  # Python
# or: bun test         # TypeScript
# or: cargo test       # Rust

If tests fail, do NOT ship. Show failures and suggest /meridian:debug.

Step 3: Commit

Stage relevant files and commit with Meridian prefix:

git add 
git commit -m "[meridian] "

Step 4: Push

git push -u origin 

Step 5: Create PR

gh pr create --title "" --body "$(cat 

## Changes

## Testing

## Meridian Context
- Milestone: 
- Phase: 
- Plans completed: 

---
Generated by Meridian
EOF
)"

Step 6: Record in State

Update plan commit SHAs and create checkpoint:

PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
from scripts.db import connect, get_db_path
from scripts.state import create_checkpoint
conn = connect(get_db_path('.'))
create_checkpoint(conn, trigger='phase_complete', notes='Shipped to PR')
conn.close()
"

Step 7: Export State

PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
from scripts.export import export_state
export_state('.')
"

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: mattjaikaran
• Source: mattjaikaran/meridian
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.