CLI Command Reference

The myk-pi-tools CLI provides subcommands for PR review management, GitHub releases, project memory, CodeRabbit integration, and review database analytics.

myk-pi-tools [OPTIONS] COMMAND [SUBCOMMAND] [OPTIONS]

Note: Most commands that interact with GitHub require the GitHub CLI (gh) to be installed and authenticated. See Installation & Setup for prerequisites.

db

Review database query commands. All subcommands read from a SQLite database stored at <git-root>/.pi/data/reviews.db.

db stats

Get review statistics grouped by source or reviewer.

myk-pi-tools db stats [OPTIONS]

Note: If neither --by-source nor --by-reviewer is specified, defaults to --by-source. Specifying both is an error.

# Stats by source (default)
myk-pi-tools db stats

# Stats by reviewer
myk-pi-tools db stats --by-reviewer

# JSON output
myk-pi-tools db stats --by-source --json

db patterns

Find recurring dismissed patterns in review comments. Identifies comments that appear multiple times with similar content, suggesting candidates for auto-skip rules.

myk-pi-tools db patterns [OPTIONS]

# Find patterns with at least 2 occurrences (default)
myk-pi-tools db patterns

# Find patterns with at least 3 occurrences
myk-pi-tools db patterns --min 3

# JSON output
myk-pi-tools db patterns --json

db dismissed

Get all dismissed (not_addressed or skipped) comments for a specific repository.

myk-pi-tools db dismissed --owner OWNER --repo REPO [OPTIONS]

# Get dismissed comments
myk-pi-tools db dismissed --owner myk-org --repo pi-config

# JSON output
myk-pi-tools db dismissed --owner myk-org --repo pi-config --json

db query

Run a raw SQL query on the review database. Only SELECT statements are allowed.

myk-pi-tools db query SQL [OPTIONS]

# Get all skipped comments
myk-pi-tools db query "SELECT * FROM comments WHERE status = 'skipped'"

# Count by status
myk-pi-tools db query "SELECT status, COUNT(*) as cnt FROM comments GROUP BY status"

# JSON output
myk-pi-tools db query "SELECT * FROM comments LIMIT 5" --json

db find-similar

Find a previously dismissed comment matching path and body similarity. Reads JSON input from stdin.

myk-pi-tools db find-similar --owner OWNER --repo REPO [OPTIONS] < input.json

Stdin input format:

{"path": "foo.py", "body": "Add error handling..."}

echo '{"path": "foo.py", "body": "Add error handling..."}' | \
    myk-pi-tools db find-similar --owner myk-org --repo pi-config --json

memory

Project memory commands for persistent per-repo learning. The memory file is a Markdown file stored at <git-root>/.pi/memory/memory.md by default.

myk-pi-tools memory [OPTIONS] SUBCOMMAND

memory add

Add a memory entry to the Learned or Pinned section.

myk-pi-tools memory add -c CATEGORY -s SUMMARY [OPTIONS]

# Add a learned memory
myk-pi-tools memory add -c lesson -s "buildah chown -R skips target dir"

# Add a pinned memory (never auto-removed)
myk-pi-tools memory add -c preference -s "Always use uv run" --pinned

memory show

Display the memory file contents.

myk-pi-tools memory show

memory migrate

One-time migration from SQLite database to memory.md. Reads all memories from memories.db, writes them to memory.md, then deletes the database.

myk-pi-tools memory migrate

memory path

Print the resolved memory file path.

myk-pi-tools memory path

pr

PR review and management commands.

pr diff

Fetch PR diff and metadata as JSON.

myk-pi-tools pr diff [ARGS]

Accepts three input forms:

Output: JSON object with metadata, diff, and files fields.

{
  "metadata": {
    "owner": "myk-org",
    "repo": "pi-config",
    "pr_number": "42",
    "head_sha": "abc123...",
    "base_ref": "main",
    "title": "Add feature X",
    "state": "open"
  },
  "diff": "...",
  "files": [
    {
      "path": "src/main.py",
      "status": "modified",
      "additions": 10,
      "deletions": 3,
      "patch": "..."
    }
  ]
}

myk-pi-tools pr diff myk-org/pi-config 42

pr claude-md

Fetch CLAUDE.md and AGENTS.md content from a PR's repository. Checks both root and config directories (.claude/, .agents/) locally and via the GitHub API.

myk-pi-tools pr claude-md [ARGS]

Accepts the same input forms as pr diff.

Searched locations (in order):

1. ./CLAUDE.md
2. ./.claude/CLAUDE.md
3. ./AGENTS.md
4. ./.agents/AGENTS.md
5. Remote equivalents via GitHub API

myk-pi-tools pr claude-md myk-org/pi-config 42

pr post-comment

Post inline comments to a PR as a single GitHub review with a summary table.

myk-pi-tools pr post-comment OWNER_REPO PR_NUMBER COMMIT_SHA JSON_FILE

JSON input format:

[
  {
    "path": "src/main.py",
    "line": 42,
    "body": "### [CRITICAL] SQL Injection\n\nDescription..."
  },
  {
    "path": "src/utils.py",
    "line": 15,
    "body": "### [WARNING] Missing error handling\n\nDescription..."
  }
]

Severity markers (parsed from comment body):

Output: JSON with status, comment_count, posted, failed, and optionally error.

myk-pi-tools pr post-comment myk-org/pi-config 42 abc123def456... comments.json

# From stdin
cat comments.json | myk-pi-tools pr post-comment myk-org/pi-config 42 abc123def456... -

Warning: Only lines that were modified or added in the PR diff can receive inline comments. The commit SHA must be the HEAD of the PR.

release

GitHub release commands for version management and release creation.

release info

Fetch release validation info and commits since the last tag. Auto-detects repository from git context.

myk-pi-tools release info [OPTIONS]

Validations performed:

• On target branch
• Clean working tree
• Synced with remote (no unpushed or behind commits)

Output: JSON with metadata, validations, last_tag, all_tags, commits, commit_count, is_first_release, target_branch, and tag_match.

Tip: On a version branch like v2.10, the command auto-detects --target v2.10 and --tag-match v2.10.*.

Commit filtering: The following are excluded from the commit list:

• Merge commits
• CodeRabbit-related commits
• Checkpoint and version bump chores
• Doc regeneration and pre-commit autoupdates

# Auto-detect everything from git context
myk-pi-tools release info

# Explicit repository and target
myk-pi-tools release info --repo myk-org/pi-config --target main

# Filter tags for a specific version line
myk-pi-tools release info --tag-match "v2.10.*"

release create

Create a GitHub release.

myk-pi-tools release create OWNER_REPO TAG CHANGELOG_FILE [OPTIONS]

Output: JSON with status, tag, url, prerelease, and draft on success; status and error on failure.

Note: A warning is emitted to stderr if the tag does not follow semantic versioning format (vX.Y.Z).

myk-pi-tools release create myk-org/pi-config v1.3.0 changelog.md

myk-pi-tools release create myk-org/pi-config v2.0.0-rc1 notes.md \
    --prerelease --target release/v2

release detect-versions

Detect version files in the current repository across multiple ecosystems.

myk-pi-tools release detect-versions

Detected file types:

Output:

{
  "version_files": [
    {"path": "pyproject.toml", "current_version": "2.2.0", "type": "pyproject"}
  ],
  "count": 1
}

myk-pi-tools release detect-versions

release bump-version

Update version strings in detected version files. Uses atomic writes to prevent file corruption.

myk-pi-tools release bump-version VERSION [OPTIONS]

Warning: The version must not start with v. Use 1.2.0, not v1.2.0.

Output: JSON with status, version, updated (list of {path, old_version, new_version}), and skipped (list of {path, reason}).

# Update all detected version files
myk-pi-tools release bump-version 1.3.0

# Update specific files only
myk-pi-tools release bump-version 1.3.0 --files pyproject.toml --files package.json

reviews

Review handling commands for fetching, responding to, and storing PR review threads.

reviews fetch

Fetch all unresolved review threads from the current branch's PR. Categorizes comments by source (human, qodo, coderabbit) and classifies priority.

myk-pi-tools reviews fetch [REVIEW_URL]

Output: Saved to /tmp/pi-work/pr-<number>-reviews.json.

# Fetch all unresolved reviews
myk-pi-tools reviews fetch

# Fetch with a specific review URL context
myk-pi-tools reviews fetch "#pullrequestreview-12345"

reviews poll

Poll for reviews with automatic CodeRabbit rate limit handling. Combines rate limit check, trigger, and fetch into a single atomic operation. Loops internally until actionable comments are found.

myk-pi-tools reviews poll [REVIEW_URL]

Output: Same format as reviews fetch (saved to /tmp/pi-work/pr-<number>-reviews.json).

myk-pi-tools reviews poll

reviews post

Post replies to review threads and resolve them based on status.

myk-pi-tools reviews post JSON_PATH

Updates the JSON file with posted_at timestamps after posting.

myk-pi-tools reviews post /tmp/pi-work/pr-42-reviews.json

reviews pending-fetch

Fetch the authenticated user's pending (unpublished) review comments from a PR.

myk-pi-tools reviews pending-fetch PR_URL

Output: Saved to /tmp/pi-work/pr-<number>-pending-review.json.

myk-pi-tools reviews pending-fetch https://github.com/myk-org/pi-config/pull/42

reviews pending-update

Update pending review comment bodies and optionally submit the review.

myk-pi-tools reviews pending-update JSON_PATH [OPTIONS]

# Update comments only
myk-pi-tools reviews pending-update /tmp/pi-work/pr-42-pending-review.json

# Update and submit
myk-pi-tools reviews pending-update /tmp/pi-work/pr-42-pending-review.json --submit

reviews store

Store a completed review to the SQLite database for analytics. Deletes the JSON file after successful storage.

myk-pi-tools reviews store JSON_PATH

Database location: <git-root>/.pi/data/reviews.db

myk-pi-tools reviews store /tmp/pi-work/pr-42-reviews.json

Tip: Use db stats and db patterns to analyze data stored by this command. See Review Database & Analytics for details.

coderabbit

Commands for managing CodeRabbit automated reviews.

coderabbit check

Check if CodeRabbit is rate limited on a PR.

myk-pi-tools coderabbit check OWNER_REPO PR_NUMBER

Output: JSON with rate limit status.

{"rate_limited": false}

{"rate_limited": true, "wait_seconds": 90, "comment_id": 12345}

myk-pi-tools coderabbit check myk-org/pi-config 42

coderabbit trigger

Wait an optional duration, then trigger a CodeRabbit review on a PR by posting @coderabbitai review. Polls until the review starts (max 10 minutes, 60-second intervals).

myk-pi-tools coderabbit trigger OWNER_REPO PR_NUMBER [OPTIONS]

# Trigger immediately
myk-pi-tools coderabbit trigger myk-org/pi-config 42

# Wait 90 seconds then trigger
myk-pi-tools coderabbit trigger myk-org/pi-config 42 --wait 90

Exit Codes

All commands use the following exit code conventions:

Error details are printed to stderr. JSON output goes to stdout.

Environment and Dependencies

See Installation & Setup for installation instructions.