Fixing notes

Fix a note however you work, then press Mark fixed. A coding agent can do the fixing too, through a runner.

  1. Find what to fix. The Inbox lists the notes on your sites. Each says the page, the window's width and what was clicked; See it at opens the page at that width.
  2. Fix it. Use whatever you build the site with. Mender never sees your code.
  3. Press Mark fixed. Tick It's live on the site already if it is. On a site that tells Mender about its deploys, leave it, and the reporter is asked once the fix is deployed.
  4. Wait for the check. The reporter is asked whether it looks fixed. Still wrong brings it back to you; if they never answer, Confirm the fix closes it.

Fixing with a runner

A runner runs on your machine or in CI. It takes queued notes, hands each to a coding agent in a fresh checkout of your repository, and opens a pull request. Mender never sees your code.

  1. Get a token and a repository. An owner or maintainer makes you a fixer token and connects the site to its repository, in Settings. The token is shown once, and lasts 30 days unless they choose otherwise.
  2. Install the runner.
    npm install -g ./mender-runner-<version>.tgz
  3. Start it from a clone of the site's repository.
    export MENDER_TOKEN=mrt_…
    mender-runner --repo . \
      --agent "claude -p --permission-mode acceptEdits --allowed-tools Read Edit Write Glob Grep"
    Its first lines say which sites it serves and how many notes are waiting.
  4. Queue a note. A runner takes only notes that have been queued. Press Queue on a note, or add a queue rule in the site's settings.
  5. Check the pull request. The note links to it. Once it is merged and live, press Mark fixed, or merge it from the note (below). If you close it unmerged, Mender does not hear, so press Still wrong or Close without a check on the note.

Merging from Mender

A pull request the runner leaves for a person can be merged from its note, by an owner or a maintainer: press Merge pull request…, read what GitHub says about it, and press Merge pull request #N. It opens two locks, and Mender holds only one of them.

To switch it on, an owner or maintainer opens the repository in Settings → Repositories and presses Install on GitHub, picks Only select repositories and the one, and comes back. GitHub shows the merge as yours. Mender keeps no GitHub key: it uses your sign-in for that one merge and keeps nothing. The note is marked fixed, and its reporter is asked to check once the site is updated.

Which token role

Fixing needs one of these two. Reader, Drafter and Triage agent tokens answer notes instead.

Unattended fixerFor a runner left running. Work it drops goes back to the queue after 15 minutes. It also queues what people marked Build this or No, change it, and dismisses Not doing this.
Session fixerFor a coding session you are sitting in, with mender-runner lease. Its leases last 8 hours.

When a runner does nothing

Also: Leaving notes, for reviewers · Setting up a site · Fixing notes