Skip to content

docs(setup): register the container-gateway hook per machine - #1797

Merged
potiuk merged 1 commit into
apache:mainfrom
potiuk:docs/gateway-hook-per-machine
Oct 25, 2026
Merged

potiuk merged 1 commit into
apache:mainfrom
potiuk:docs/gateway-hook-per-machine

Conversation

@potiuk

@potiuk potiuk commented Oct 25, 2026

Copy link
Copy Markdown
Member

Since #1793 the container-gateway hook is registered by its absolute path, which differs between macOS (/Users/<you>) and Linux (/home/<you>). In a ~/.claude/settings.json synced across machines, that path points at nothing on the next machine, and the gateway never starts there.

  • The setup guide and install Step L put the hook in ~/.claude/settings.local.json when the user settings are synced; Claude Code merges hooks from both files.
  • A "Fixing your other machines" passage: remove the entries from the synced file once, then run a jq one-liner on each machine to register them with that machine's home.
  • The syncing section notes that per-machine entries stay out of the synced file.
  • Verify check 12a and the update skill flag a registered path that doesn't exist on the machine they run on, and a registration in a synced settings.json as drift.

🤖 Generated with Claude Code

Since apache#1793 the gateway hook is registered by its absolute path, which
differs between macOS (/Users/<you>) and Linux (/home/<you>). In a
~/.claude/settings.json synced across machines that path points at
nothing on the next machine and the gateway never starts. The setup guide
and install Step L now put the hook in ~/.claude/settings.local.json when
the user settings are synced, with a "Fixing your other machines" passage
(move the entries, then a jq one-liner per machine). Verify check 12a and
the update skill flag a registered path that does not exist on the machine
they run on, and a synced registration as drift.

Generated-by: Claude (Opus 5.5)
@github-actions github-actions Bot added family:setup setup-* skills family:docs Docs, MISSION.md, READMEs capability:platform Framework / agent substrate skills (install, verify, doctor, override, status, setup bootstrap) labels Oct 25, 2026
@potiuk
potiuk enabled auto-merge (squash) October 25, 2026 00:10
@potiuk
potiuk merged commit d871258 into apache:main Oct 25, 2026
10 checks passed
potiuk added a commit that referenced this pull request Oct 25, 2026
Ships the fixes merged since 0.9.0.dev202610241347 to marketplace installs:
the container-gateway hook hardening (#1784, #1789, #1790, #1793, #1804),
host-only uv state (#1785), session-start cleanup of the stale uv grant
(#1788), the trusted session-start interpreter (#1791), the sandboxed prek
home (#1792) and per-machine gateway hook registration (#1797).

Generated-by: Claude (Opus 5.5)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

capability:platform Framework / agent substrate skills (install, verify, doctor, override, status, setup bootstrap) family:docs Docs, MISSION.md, READMEs family:setup setup-* skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant