Repository navigation
Releases
1.43.0
Homer
- Fixed:
homer-runnerreports its release version — A pull runner registers with the version of the release it was built from (devfor a source build) instead of0.1.0, and Homer rejects a malformed version. - Added:
/api/v1/callback/whoami— Resolves a run's callback token to its process id and agent, so an egress proxy can apply a per-agent policy. See ADR-0110. - Changed: the runner and queue status reads admit a
readgrant on*— A principal grantedreadon every agent can pollGET /api/v1/runners,/api/v1/runners/queueand/api/v1/maintenancewithoutrole: admin, with the operator-chosen runner aliases and instance names withheld. See ADR-0111. - Added: runner instance
versiononGET /api/v1/runners— Each pull-mode instance carries the version it registered with,nullwhen it reported none; aversionoutside the tag shape is refused at registration with422.
Console
- Added: version column and mismatch marker on the Runners page — Each external runner instance shows its reported version, with an exclamation mark when it differs from the Homer server's.
Full changelog: 1.42.0...1.43.0
Images
Each digest is a multi-arch index (linux/amd64 and linux/arm64), signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM of each platform (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.43.0 |
sha256:0c04544fe224a1ee135afdcf95f0b015390e28a17468f4c5ec6b82ed1fb28769 |
ghcr.io/livesport/homer/homer-app:1.43.0-slim |
sha256:50d43f3b75cb4184cfe526871f8416c18a687d512d8d9489f676845b354d3964 |
ghcr.io/livesport/homer/homer-runner:1.43.0 |
sha256:0504ba3a6c8b1f77755370419cb869425e58c960d9a6bc0e3fee9a514c9e9b5f |
ghcr.io/livesport/homer/homer-console:1.43.0 |
sha256:c866ada1ed4ea0d75e824e7dd2bb7b03da8b56265dddcedda1fa5e463d12bfb0 |
Verify each image before you pull it, then pin its digest:
cosign verify ghcr.io/livesport/homer/homer-app@sha256:0c04544fe224a1ee135afdcf95f0b015390e28a17468f4c5ec6b82ed1fb28769 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.43.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-app@sha256:50d43f3b75cb4184cfe526871f8416c18a687d512d8d9489f676845b354d3964 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.43.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-runner@sha256:0504ba3a6c8b1f77755370419cb869425e58c960d9a6bc0e3fee9a514c9e9b5f \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.43.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-console@sha256:c866ada1ed4ea0d75e824e7dd2bb7b03da8b56265dddcedda1fa5e463d12bfb0 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.43.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com1.42.0
Homer
- Added: grouped ask-and-dispatch — Registers several questions as one dispatch and starts the target agent once, after every answer. See ADR-0109.
- Added:
hookson the agent definition — A run status can declare an agent Homer starts when a run of that agent reaches it, from every start path, delivered exactly once across restarts and bounded byserver.hooks. See ADR-0107. - BREAKING: LLM generation span attributes renamed to
langfuse.observation.*— A!<claude>/!<codex>/!<opencode>generation'sprompt/outputare nowlangfuse.observation.input/langfuse.observation.output, the pair Langfuse reads before any framework fallback, so its Output renders and a dashboard or filter on the old names must move. - Added:
retriesandinfra_retriesonhomer_fanout— A LangGraph fan-out node re-dispatches a sub that failed, up to a bounded number of attempts and with a separate budget for infrastructure outcomes, instead of resuming with the same failed payload forever. See ADR-0105. - Fixed: recovering a LangGraph thread whose node raised — A thread whose latest checkpoint still holds a failed task is re-entered instead of being reported finished with an empty final state.
- Fixed: a lost Kubernetes exec channel names itself — A step whose exec channel into a still-running pod closes without a status now fails with the cause in its error, the run's
runner.terminationnames the loss, and the leftover command is killed before the step fails. See ADR-0103. - Fixed: a failed dispatch's reported error reason — A failure carrying no message now reports the same
Dispatch failedfallback the stored row keeps, instead of an empty error. - Fixed: a run refused before it started no longer arms
cooldown.afterFailure— ASKIP_CURRENTlock skip, aREJECTor a full queue endsFAILEDwithout running, so it no longer backs the agent off for the whole window. - Added: a load-time warning for a Claude step that limits tools only with
allowedTools— A step that skips permissions and sets neithertoolsnordisallowedToolsrestricts nothing; Homer warns at agent load andagentdebug validatereports it on the command's line. - Changed: a run's Langfuse trace name and tags reach every span it exports — Langfuse v4 reads both off each observation, so the run's name and subject tags now ride on every span and the exporter declares OTLP ingestion version 4. See ADR-0050.
- Fixed: a stalled Kubernetes API server no longer holds a run — The runner's non-streaming API reads now fail after a fixed 30 s instead of hanging, so the run ends and its runner slot is freed; exec and workspace-sync streams stay open as long as the command needs. See ADR-0100.
- Fixed: a
jsonPathtransformer selecting an object or array — Was captured as Java map text ({a=1}); it is now compact JSON, so a later command or graph node receives parseable text. Strings, numbers and booleans are unchanged. - Added:
continuation.inheritInputson the agent definition — A continuation or dispatch fired back to the same agent can carry the registering run's inputs, so a resumed segment keeps its lock key's subject and itstags.fromInputstags. See ADR-0101. - Fixed: a
!<claude>result flaggedis_errorfails the step — Runs that reportedsubtype: "success"while the CLI flagged an error (a refusal, an unavailable deferred tool, an API error) now fail instead of finishing green, so theirretryandescalatetiers run and theirafterFailurecooldowns arm. - Fixed: shutdown drain waits for runs started during the drain — A shutdown now also finishes the
!<agent>hops, dispatches and continuations its in-flight runs start, and runs already waiting for a runner claim, instead of killing them and leaving themUNKNOWN; a new top-level start during the drain is refused with503. See ADR-0102. - Added:
cooldown.keyon the agent definition — Counts an agent'sminIntervalandafterFailurewindows per rendered subject, so a reviewer paced per merge request is no longer held back by another request's run; a key that cannot be rendered fails the start with400. See ADR-0106. - Changed: a run waiting for a lock no longer holds a
maxParallelRunsslot — A run takes its lock before its slot, so one busy subject no longer starves the agent's other subjects;SKIP_CURRENTnow refuses before any slot wait,KILL_OLD_RUN_CURRENTkills the old run only once the new one holds a slot, and runs waiting for a lock are bounded bymaxQueuedRuns, else bymaxParallelRuns. See ADR-0104. - BREAKING: a
lockStrategy.keyplaceholder with no value fails the run before it starts — It used to stay literal, so every run of that agent rendered the same key and unrelated runs were skipped, queued behind or killed by each other; the run now endsFAILEDwith afailureReasonnaming the placeholder, taking no lock, slot or workspace. See ADR-0098. - Added: graceful stop of a run — A step's
onTimeout: stopand a Kubernetes runner'sgracefulStopSecondsstop a run gracefully, so the agent'sonStop:steps run withHMR_STOP_*before it endsFAILEDwith astoprecord. See ADR-0108. - Fixed: a
!<claude>step stopped atmaxTurnshonoursmaxTurnsExitCodewhen the CLI exits non-zero — The stop is no longer taken for a crash, so the step returns the configured exit code and a later step can tell it from a failure.
Full changelog: 1.41.0...1.42.0
Images
Each digest is a multi-arch index (linux/amd64 and linux/arm64), signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM of each platform (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.42.0 |
sha256:05987c62bc8eff5c255c1e5e73bf8f4fda93e3623be659408514a54773344529 |
ghcr.io/livesport/homer/homer-app:1.42.0-slim |
sha256:3004475867f2939cd69f24c9dd071b93d64a519014b3ea6b70d87fa48a7d71bc |
ghcr.io/livesport/homer/homer-runner:1.42.0 |
sha256:879667baa19689f1c9f0ee94d013ad5a5791102a50190f76a2d4ec6e8c86536d |
ghcr.io/livesport/homer/homer-console:1.42.0 |
sha256:8439f29ef59c434d19d172c2565017390ca293a04ce892fff249a5228a0aaec9 |
Verify each image before you pull it, then pin its digest:
cosign verify ghcr.io/livesport/homer/homer-app@sha256:05987c62bc8eff5c255c1e5e73bf8f4fda93e3623be659408514a54773344529 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.42.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-app@sha256:3004475867f2939cd69f24c9dd071b93d64a519014b3ea6b70d87fa48a7d71bc \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.42.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-runner@sha256:879667baa19689f1c9f0ee94d013ad5a5791102a50190f76a2d4ec6e8c86536d \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.42.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-console@sha256:8439f29ef59c434d19d172c2565017390ca293a04ce892fff249a5228a0aaec9 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.42.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com1.41.0
Homer
- Fixed: kubernetes runner pods rejected by RuntimeClass admission — Pods no longer carry an empty
overheadfield, which current Kubernetes versions refuse. See ADR-0100. - Added:
maxRunSecondsfor the kubernetes runner — A hard per-run limit enforced by Kubernetes on the pod; any run whose pod Kubernetes stops (the limit, eviction, OOM, deletion) now fails with the reason in the newrunner.terminationfield. See ADR-0100. - Added:
workload: Jobfor the kubernetes runner — Runs each session's pod in a one-pod Kubernetes Job that waits out namespace quota and is removed by its TTL even when Homer is down; the run'srunner.jobNameand the health sweep'sdeletedJobsname the Jobs. See ADR-0100. - Security: kubernetes runner failure text omits a container's termination log — A failed container is reported by its exit code instead of the termination message, which the agent can write. See ADR-0100.
- Fixed: a run that starts another run can finish during maintenance mode — A
!<agent>hop, a dispatch or a continuation fire whose own run is stillWORKINGis admitted at once instead of parking in the maintenance queue, while a start with no parent or one whose origin has ended still queues. See ADR-0092.
Full changelog: 1.40.0...1.41.0
Images
Each digest is a multi-arch index (linux/amd64 and linux/arm64), signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM of each platform (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.41.0 |
sha256:6fea2e4d510a2a4671e20673d4a733e7d0adc212c93e05aa46030b62ab002804 |
ghcr.io/livesport/homer/homer-app:1.41.0-slim |
sha256:185da3a063b0147f8e3953ad08778e16e13731de17b9a6aa0ba4d4dbe7a9768a |
ghcr.io/livesport/homer/homer-runner:1.41.0 |
sha256:8a56385b9252b0506f122fe1e2cd5ea4ae08116b7338e02f1db3347c5e9e602a |
ghcr.io/livesport/homer/homer-console:1.41.0 |
sha256:a6d83a2f573fd0f3e3219412620fb42844a76f7467a4a1b1c4b59881cadf2476 |
Verify each image before you pull it, then pin its digest:
cosign verify ghcr.io/livesport/homer/homer-app@sha256:6fea2e4d510a2a4671e20673d4a733e7d0adc212c93e05aa46030b62ab002804 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.41.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-app@sha256:185da3a063b0147f8e3953ad08778e16e13731de17b9a6aa0ba4d4dbe7a9768a \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.41.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-runner@sha256:8a56385b9252b0506f122fe1e2cd5ea4ae08116b7338e02f1db3347c5e9e602a \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.41.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-console@sha256:a6d83a2f573fd0f3e3219412620fb42844a76f7467a4a1b1c4b59881cadf2476 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.41.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com1.40.0
Homer
- Added:
runnerAffinityon the agent definition — Opts a flow into staying on the runner instance that served its earlier runs, within a bounded wait and with immediate fallback. See ADR-0099. - Changed: the homer-app image pins the Claude Code CLI version — A build installs a chosen release of the CLI instead of whatever npm published that day; the
CLAUDE_CODE_VERSIONbuild argument overrides the pin. - BREAKING: a runner instance name is held by one live registration — Registering a second live instance with a name already held in the same domain is refused with 422, so a
runnerAffinitypreference can never name two instances; a name held by a draining or expired instance is free again.
Console
- Added: Start time column on the process list — Each run shows when it started, before its duration.
- Changed: the process list's Commands column — Each run shows its command squares only, six to a line, with the command and, once it has ended, its duration in each square's tooltip; the columns are reordered and the kill button is a red circle-with-cross icon.
Full changelog: 1.39.0...1.40.0
Images
Each digest is a multi-arch index (linux/amd64 and linux/arm64), signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM of each platform (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.40.0 |
sha256:b9eff232e8414602194a910163d2ea57d0d5ba608f4fd2808776ef8949d6ec8f |
ghcr.io/livesport/homer/homer-app:1.40.0-slim |
sha256:30f5f2df6a74ea01f344eb28728409323bb4a945b26705ea018c8555d285805f |
ghcr.io/livesport/homer/homer-runner:1.40.0 |
sha256:338b412f7a8597f45f1fc3700956f9653f0bdf5b6d0453adcff4d10028e831a6 |
ghcr.io/livesport/homer/homer-console:1.40.0 |
sha256:140d8f24133755e20666269d012e4a473bd1a1ba32e42323b828e3e08f2059ce |
Verify each image before you pull it, then pin its digest:
cosign verify ghcr.io/livesport/homer/homer-app@sha256:b9eff232e8414602194a910163d2ea57d0d5ba608f4fd2808776ef8949d6ec8f \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.40.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-app@sha256:30f5f2df6a74ea01f344eb28728409323bb4a945b26705ea018c8555d285805f \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.40.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-runner@sha256:338b412f7a8597f45f1fc3700956f9653f0bdf5b6d0453adcff4d10028e831a6 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.40.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-console@sha256:140d8f24133755e20666269d012e4a473bd1a1ba32e42323b828e3e08f2059ce \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.40.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com1.39.0
Console
- Changed: a more compact process list — Each run shows its total duration and a dot per executed command, status is an icon, and the Status Time and Purge columns are gone.
Homer
- Added: a
limitsexample agent — DemonstratesmaxParallelRuns,onMaxParallelRuns,maxQueuedRunsandcooldownon a slow script. - Added:
!<opencode>command type — Runs the opencode CLI as a third LLM harness, with the same retry, escalation, cost accounting and conversation view. See ADR-0070. - Changed: the runner image pins the Codex and opencode CLI versions — A build installs a chosen release of each CLI instead of whatever npm published that day; the
CODEX_VERSIONandOPENCODE_VERSIONbuild arguments override the pins.
Full changelog: 1.38.0...1.39.0
Images
Each digest is a multi-arch index (linux/amd64 and linux/arm64), signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM of each platform (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.39.0 |
sha256:6ec6ff09aea977bb3f732f8da489d509bf398e9797617940a1b10e3b275c0cbe |
ghcr.io/livesport/homer/homer-app:1.39.0-slim |
sha256:1832c00f94b63ae986c3dd2348497e7d79ecaf029022b86045e3860abb82e90b |
ghcr.io/livesport/homer/homer-runner:1.39.0 |
sha256:42a4af9e31a5ac170a76fe69a0f4d8beca234f39cac1a1e4a4f792ac5f358113 |
ghcr.io/livesport/homer/homer-console:1.39.0 |
sha256:e8f28f9c57c7200f78fc70034fcc0a1d2c0aba0b4af0663c5c0905998d936d18 |
Verify each image before you pull it, then pin its digest:
cosign verify ghcr.io/livesport/homer/homer-app@sha256:6ec6ff09aea977bb3f732f8da489d509bf398e9797617940a1b10e3b275c0cbe \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.39.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-app@sha256:1832c00f94b63ae986c3dd2348497e7d79ecaf029022b86045e3860abb82e90b \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.39.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-runner@sha256:42a4af9e31a5ac170a76fe69a0f4d8beca234f39cac1a1e4a4f792ac5f358113 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.39.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-console@sha256:e8f28f9c57c7200f78fc70034fcc0a1d2c0aba0b4af0663c5c0905998d936d18 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.39.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com1.38.0
Homer
- Added:
failureReasonon the process status response — A run that endedFAILEDbefore any command started (a claim timeout, aSKIP_CURRENTlock skip, a parallel-run cap or a full queue) carries a stored sentence saying which. - Added: run-message API and
server.messageslimits —POSTandGET /api/v1/status/{processId}/messagessend and list a run's inbox,POST /api/v1/callback/messages/takehands the run its queued messages (as plain text, Claude-hook JSON or thecheck_messagesMCP tool),message.queued/delivered/undeliveredstream on/stream/processes, and the newserver.messagesconfig bounds message size and count. See ADR-0097. - Added: an optional
groupon the agent definition — Labels an agent for the console;GET /api/v1/agentsand the process API return it, read from the agent's current definition. - Fixed: code names split mid-word in documentation-site tables — A code or type name in a table cell stays on one line, and a table too wide for the page scrolls sideways instead.
Console
- Added: why a run failed before it started — The process list and the run's own page show the stored reason beside the
FAILEDstatus. - Added: per-run inbox — Operators can send messages to a running run (bounded by
server.messages), which reads them through the newhomer-inboxhelper, Claude hooks or thecheck_messagesMCP tool; undelivered messages are marked when the run ends. See ADR-0097. - Added: message box on a running run — Send a message to a running run from its page and see whether it was delivered.
- Added: agent group tabs — The Agents page shows an All tab plus one tab per agent group, and a run's agent group is shown on the process list and detail.
Full changelog: 1.37.1...1.38.0
Images
Each digest is a multi-arch index (linux/amd64 and linux/arm64), signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM of each platform (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.38.0 |
sha256:cacc12fb34996a8eeeb51c9073adb705468cbe165ef029e6e3494e857aaad5fe |
ghcr.io/livesport/homer/homer-app:1.38.0-slim |
sha256:9a8c4dca4757ee1dbdefe61618101a89cd8465f038933114d596b7173d0a0d73 |
ghcr.io/livesport/homer/homer-runner:1.38.0 |
sha256:76446746f28c1ca888432affae415377af6d0bfbbabfc1fb1de26618df69b58b |
ghcr.io/livesport/homer/homer-console:1.38.0 |
sha256:be123d3fcbb0d45ba441d2eab60f391241a630917ba09f4ed827fafc0ce51fc9 |
Verify each image before you pull it, then pin its digest:
cosign verify ghcr.io/livesport/homer/homer-app@sha256:cacc12fb34996a8eeeb51c9073adb705468cbe165ef029e6e3494e857aaad5fe \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.38.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-app@sha256:9a8c4dca4757ee1dbdefe61618101a89cd8465f038933114d596b7173d0a0d73 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.38.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-runner@sha256:76446746f28c1ca888432affae415377af6d0bfbbabfc1fb1de26618df69b58b \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.38.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-console@sha256:be123d3fcbb0d45ba441d2eab60f391241a630917ba09f4ed827fafc0ce51fc9 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.38.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com1.37.1
Homer
- Fixed: an external runner dropped the end of a step's output — A step on a pull runner now finishes sending its output before reporting its exit code, or gives up on a stalled drain with one logged warning that leaves the tail unreported; output a reported count shows as still missing fails the step instead of passing as truncated.
- Fixed: runner-protocol bodies refused on unknown fields — A body carrying a field this Homer does not know is decoded for what it knows instead of answered with a 400, so mixed-version deployments no longer lose an op result to a newer peer's extra field.
- Fixed: homer-runner kept claiming runs it could not start — Before registering and before each claim the runner checks that it can start a process and write under
--root; when it cannot, it stops claiming, deregisters, lets in-flight runs finish and exits 3 for its supervisor to restart. See ADR-0096. - Fixed: one fast-failing runner instance took most runs — A new run goes to the idle matching runner that claimed least recently, instead of to whichever waiting poll wins a race, so an instance that fails every run at once no longer takes every run. See ADR-0096.
- Fixed:
agentdebug validateexit status — The command exits 1 when the agent is not found or schema validation fails, and 0 when it passes. - Fixed: moving the compose ports broke the console's API calls — The example configs take the console origin from
@SYSENV:FRONTEND_PORTand the console's API URL follows the backend's publishedBACKEND_PORT, so changing either port in.envis the only step. See ADR-0093. - Added: a
tagged-runexample agent — A bundled example shows run tags in use: subject tags resolved from the agent's inputs and a runtime tag declared mid-run withhomer-tag.
Console
- Fixed: console sign-in on a first visit — A reader who opens a console page without a session gets a neutral "Sign in to continue" prompt instead of "session expired", opens on the Token form when the deployment offers bearer sign-in, and returns to the page they asked for after signing in; a bearer session that really expired — even one already dead when the page loads — still says so, and a cookie session that expires mid-use does too.
- Fixed: the Last Command column named a skipped command — A run's last command is now the last one that actually ran, not a trailing step skipped by its
when:condition; a run whose every command was skipped shows an empty cell.
Full changelog: 1.37.0...1.37.1
Images
Each digest is a multi-arch index (linux/amd64 and linux/arm64), signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM of each platform (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.37.1 |
sha256:af367fee34684c6dfd04d775606c1e9579c57f2bb3f392796b94ce72022422f7 |
ghcr.io/livesport/homer/homer-app:1.37.1-slim |
sha256:12aae34bae679fc249ffdf51b4f9bf89338c736429c0b2de3ea66ca9a55a1003 |
ghcr.io/livesport/homer/homer-runner:1.37.1 |
sha256:da8e5027700d50e54fdfbd1e95da2d680bb7c6bbd5c9ca6cd434b460dc0e7f94 |
ghcr.io/livesport/homer/homer-console:1.37.1 |
sha256:cb2a4df92ede230b057d08fd29a4363cd8c0f94b3c6f97b6df22b6cede6361f6 |
Verify each image before you pull it, then pin its digest:
cosign verify ghcr.io/livesport/homer/homer-app@sha256:af367fee34684c6dfd04d775606c1e9579c57f2bb3f392796b94ce72022422f7 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.37.1 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-app@sha256:12aae34bae679fc249ffdf51b4f9bf89338c736429c0b2de3ea66ca9a55a1003 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.37.1 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-runner@sha256:da8e5027700d50e54fdfbd1e95da2d680bb7c6bbd5c9ca6cd434b460dc0e7f94 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.37.1 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-console@sha256:cb2a4df92ede230b057d08fd29a4363cd8c0f94b3c6f97b6df22b6cede6361f6 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.37.1 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com1.37.0
Homer
- Fixed: agentdebug param types —
validateandshow-commandsnow print each param type as written in agent files (string,integer) instead of the internal enum name. - Added:
@SYSENV:placeholders inserver.corsAllowedOrigins— An entry such ashttp://localhost:@SYSENV:FRONTEND_PORTis resolved at startup. - BREAKING:
server.corsAllowedOriginsentries must be bare origins — An entry with a path, query, fragment, credentials or port 0, previously accepted with that part ignored, now fails startup; usehttp(s)://host[:port]with a port of 1–65535. - Fixed: bundled example agents use typed inputs — The example agents no longer log deprecation warnings at startup; they use
inputs:and typed params, and thehelloexample'sproject_idnow accepts only letters, digits,_and-. - Added: slim
homer-app:<version>-slimimage — A server image without the agent CLIs (Claude Code, Codex, Node.js, git), for deployments whose agents run on pull runners. See ADR-0094. - Changed: a smaller
homer-appimage — The image no longer ships npm's download cache or SQLite native libraries for other platforms, so the first pull is about 300 MB (a third) smaller. - Added:
server.localRunner.enabledconfig —falseregisters no local runner, so a run routed tolocalfails at once instead of executing in the server's container. See ADR-0095. - Fixed: quick-start console sign-in — The Docker Compose quick start now enables console sign-in with the admin token, instead of leaving the console unauthenticated against a bearer-only backend. See ADR-0011.
- Added: linux/arm64 release images — Every release image is published for
linux/amd64andlinux/arm64, so it runs natively on arm64 hosts such as Apple Silicon. See ADR-0086.
Console
- Fixed: an unreachable or rejecting API no longer leaves the console loading forever — The process detail, process list and questions pages say whether the API rejected the request, cannot be reached (down or blocked by CORS), or has no such process.
Full changelog: 1.36.0...1.37.0
Images
Each digest is a multi-arch index (linux/amd64 and linux/arm64), signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM of each platform (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.37.0 |
sha256:8b30c2fca367f975e7632467eaa46a7f8eef51063b4d089060566e66079dd449 |
ghcr.io/livesport/homer/homer-app:1.37.0-slim |
sha256:cbe98247e7d3cfe1057a45f002ca73f8d77a434cdd7c1c1d9fe65e3117518048 |
ghcr.io/livesport/homer/homer-runner:1.37.0 |
sha256:393bf95046793fc69c2026184313cd1b5c6fda65c645b141b32fd336fc05cecd |
ghcr.io/livesport/homer/homer-console:1.37.0 |
sha256:dd646eb63fe9ea49005558133370aa420a9ccc693f3115fe10be5823eac27247 |
Verify each image before you pull it, then pin its digest:
cosign verify ghcr.io/livesport/homer/homer-app@sha256:8b30c2fca367f975e7632467eaa46a7f8eef51063b4d089060566e66079dd449 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.37.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-app@sha256:cbe98247e7d3cfe1057a45f002ca73f8d77a434cdd7c1c1d9fe65e3117518048 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.37.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-runner@sha256:393bf95046793fc69c2026184313cd1b5c6fda65c645b141b32fd336fc05cecd \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.37.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-console@sha256:dd646eb63fe9ea49005558133370aa420a9ccc693f3115fe10be5823eac27247 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.37.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com1.36.0
Homer
- Changed:
docker compose uppulls the published release images — The stack no longer builds locally;HOMER_VERSIONpicks the release tag, and building from source moves to thedocker-compose.build.ymloverlay. See ADR-0093. - Added: a credentials-free
quickstartexample agent — The Quick start now runs a script-only agent that asks a question in the console and finishes on the answer, so a first run needs no LLM credentials. - Added: admin maintenance mode — An admin-only
GET /api/v1/maintenance(read) andPOST /api/v1/maintenance(toggle) queue new agent starts and skip cron fires until the mode is turned off, while runs already in progress finish; the queue is bounded (newserver.maintenanceconfig keys) and the mode survives a restart. See ADR-0092.
Console
- Security: the console's bundled DOMPurify and Next.js move past critical advisories — A DOMPurify sanitiser bypass and an unauthenticated remote-code-execution path in Next.js image optimization no longer apply to the shipped bundle.
- Added: a maintenance banner — A red alert bar across every dashboard page while the backend's maintenance mode is on, so a run that seems to do nothing has an explanation on screen.
- Security:
next16.4.2 — The console's shipped dependency graph leaves the Next.js 16.0.0–16.4.0 advisory range, so thenpm auditgate passes again.
Full changelog: 1.35.0...1.36.0
Images
Signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.36.0 |
sha256:92c1e1220223cb3afe3853ac5e51ebd20b45178db83774b21bca0bdbfd6a98e5 |
ghcr.io/livesport/homer/homer-runner:1.36.0 |
sha256:a3aa9314b8a666e6ef6dcfb7aafaeddeb659c6cfbf0aaa3f72be9bff31f690c8 |
ghcr.io/livesport/homer/homer-console:1.36.0 |
sha256:668ae64bcf34390b2d59fa0d5d331339a042460d899a8f56a2b9c89b5c012d90 |
Verify each image before you pull it, then pin its digest:
cosign verify ghcr.io/livesport/homer/homer-app@sha256:92c1e1220223cb3afe3853ac5e51ebd20b45178db83774b21bca0bdbfd6a98e5 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.36.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-runner@sha256:a3aa9314b8a666e6ef6dcfb7aafaeddeb659c6cfbf0aaa3f72be9bff31f690c8 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.36.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify ghcr.io/livesport/homer/homer-console@sha256:668ae64bcf34390b2d59fa0d5d331339a042460d899a8f56a2b9c89b5c012d90 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.36.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com1.35.0
The first release published from GitHub.
Homer
- Security: the feature atlas builds its section links as DOM nodes — A section heading's text is no longer inserted as HTML into the navigation rail (CWE-79), and the documentation site extracts the atlas's script whatever the tag's case.
- Changed: the project moved to GitHub — The plugin marketplace, the published images (now on GHCR), the feature atlas and private vulnerability reports live at
github.com/livesport/homer. Release images are signed with cosign and carry SLSA provenance and a CycloneDX SBOM. See ADR-0086. - Security: regex transformers are evaluated under a time bound — A catastrophic or uncompilable pattern now aborts and the value is omitted instead of pinning a CPU or failing the run; after one match is shed, later
regextransformers of the samequeryParamsorresultEnvParamlist are omitted without being evaluated. - Changed: an LLM step no longer waits for its session-spend lookup — With
llmPrice.sessionSpendconfigured, a finished!<claude>or!<codex>step is recorded at once on the CLI figure (costSource: nonefor Codex, which has none), markedfallbackReason: session figure pending, and the next step starts; the lookup settles in the background, charging the run and replacing the step's accounting when it answers, through a bounded hand-off (at most eight waiting at once, 45 s each) that sheds past a bound and leaves the trace on the pending figure. Up to 35 s less per LLM step. See ADR-0089. - Fixed: the backend image build could hang on glab's update check — The image's
glabno longer checks its upstream for a newer release, at build time or when agents call it, so a build host or runner without that route no longer stalls. - Changed: fifteen more case studies on the documentation site — Durable LangGraph pipelines, chat intake and operator questions, cross-agent locks, runner capacity, macOS build hosts, agent linting and cost through an LLM gateway. See ADR-0087.
- Changed:
allowedToolsdocumented as pre-approval, not containment — The agent format reference now says it restricts nothing once permissions are skipped;disallowedToolsortoolsis what contains a step.
Images
Signed with cosign (keyless) and carrying SLSA provenance and a CycloneDX SBOM (ADR-0086).
| Image | Digest |
|---|---|
ghcr.io/livesport/homer/homer-app:1.35.0 |
sha256:6ef25861eccd3f1a499bad60465c8e57828368e822ada87abb9cb9f94a3d9605 |
ghcr.io/livesport/homer/homer-runner:1.35.0 |
sha256:da9bef6c08503152d5c9420ac7ca74dcd293b4a6403b6f2727536a7395604885 |
ghcr.io/livesport/homer/homer-console:1.35.0 |
sha256:f7f8d76b4405b1c126550455395c24fce2e04bc26f4c8b3a844b6dac976c3d2a |
Verify before you pull, then pin the digest:
cosign verify ghcr.io/livesport/homer/homer-app:1.35.0 \
--certificate-identity https://github.com/livesport/homer/.github/workflows/release.yml@refs/tags/1.35.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.comFull history: CHANGELOG.md.