using-reviews-locally

Using Reviews Locally

Use this skill for local Reviews workflows from a checkout of this repo.

Start the Server

Use the project script:

lsof -iTCP:4000 -sTCP:LISTEN
./bin/server

Do not run mix phx.server directly unless you know OAuth/env loading is unnecessary. ./bin/server sources .env.local and runs Phoenix on http://localhost:4000.

Local CLI Config

The CLI reads ~/.config/reviews/config.toml and currently uses [default].

Expected shape:

[default]
server_url = "http://localhost:4000"
api_token = "rev_..."

If the user's real default points to Fly, avoid editing it casually. For one-off local pushes, create a temporary home/config:

mkdir -p /private/tmp/reviews-local-home/.config/reviews
# write /private/tmp/reviews-local-home/.config/reviews/config.toml
HOME=/private/tmp/reviews-local-home cli/target/release/reviews push --update <slug>

Mint Local Tokens

Preferred path:

1. Open http://localhost:4000/settings.
2. Sign in locally.
3. Generate an API token.
4. Use it in the CLI config.

Fallback for Codex when the local signed-in user exists and direct DB access is appropriate:

POSTGRES_HOST=localhost POSTGRES_PORT=<port> mix run -e 'user = Reviews.Repo.get_by!(Reviews.Accounts.User, username: "local-codex"); {:ok, _token, raw} = Reviews.Accounts.mint_token(user, %{"name" => "codex-local-push"}); IO.puts(raw)'

Find the DB port by inspecting the running BEAM process connections if needed:

lsof -nP -iTCP:4000 -sTCP:LISTEN
lsof -p <beam-pid> | rg "localhost:.*->localhost:"

Local and hosted tokens are not interchangeable.

Push Reviews and Revisions

Create a new review:

cli/target/release/reviews push --packet /path/to/packet.md

Append a patchset:

cli/target/release/reviews push --update <slug> --packet /path/to/packet.md

Push current uncommitted work:

cli/target/release/reviews push --update <slug> --range HEAD --packet /path/to/packet.md