kim-em/PalomarReviewer

Palomar Reviewer

An operator-run tool for reviewing mechanically passing Palomar submissions. Nothing here runs in CI.

palomar-review finds open issues labeled status:awaiting-review, checks out the immutable source and a pinned PalomarPolicy commit, executes the ordered policy prompts with Codex, Claude, or another JSON-producing command, validates the final report, and optionally:

• claims and labels the issue;
• posts the public editorial decision;
• prepares a database branch and pull request for an accepted entry.

The operator remains responsible for inspecting the report and merging the database PR. The tool never merges.

Install

uv tool install git+https://github.com/kim-em/PalomarReviewer.git
palomar-review doctor

gh must be authenticated as the operator. Install and authenticate at least one review engine:

codex login
# or
claude auth

Typical review

Preview the queue without changing GitHub:

palomar-review list
palomar-review run --issue 12 --engine codex --model gpt-5.6-sol

The second command writes a complete packet and report under .palomar-reviews/12/, but does not alter labels or comments.

After inspecting that output, run and publish the editorial result:

palomar-review run --issue 12 --engine codex --model gpt-5.6-sol --apply

If the decision is accept, prepare the append-only database PR:

palomar-review publish --issue 12

publish validates the generated record against the database schema, pushes an issue-specific branch to kim-em/PalomarDatabase, and opens a PR. It refuses non-accept decisions and existing entry filenames.