Skip to content

docs(skill): cover the toolbox shim, a route without a qualified host, and UDP - #186

Merged
filippolmt merged 2 commits into
mainfrom
docs/skill-toolbox-shim
Nov 11, 2026
Merged

filippolmt merged 2 commits into
mainfrom
docs/skill-toolbox-shim

Conversation

@filippolmt

@filippolmt filippolmt commented Nov 11, 2026 •

Copy link
Copy Markdown
Owner

Feedback from an agent operating proximo from a toolbox container, verified live in one (shim on proximo 0.18.0):

  • Inside toolbox proximo is a bridge shim and config is refused as host-only. The Skill now says where the agent finds what config would print: the TLD from traefik.<tld> in proximo status, the CA already trusted ($TOOLBOX_PROXIMO_CA), the inventory at /etc/toolbox/proximo. A config change is the developer's.
  • A route without qualified in status --json (the stack's own routes, a container outside a Compose project) is expected per docs/routing.md: use bare.
  • UDP, plain TCP and a listener a LAN device must reach stay outside proximo: publish the port directly.

make check passes locally. CI's ci.yml ignores **.md, so the Go tests (internal/skill included) do not run on this PR; they ran locally.

…, and UDP

Feedback from an agent operating proximo from a toolbox container:

- Inside toolbox `proximo` is a bridge shim and `config` is host-only, so
  the Skill now says where the TLD comes from there (the traefik.<tld>
  route in status) and that the CA path, the inventory directory and any
  `config` change are the developer's to provide.
- A route without `qualified` in `status --json` (the stack's own routes,
  a container outside a Compose project) is expected: use `bare`.
- UDP, plain TCP and a listener a LAN device must reach stay outside
  proximo: publish the port directly.
… has

Verified in a toolbox container: the CA is trusted system-wide and named
by $TOOLBOX_PROXIMO_CA, and routes.json is mounted at
/etc/toolbox/proximo (toolbox's proximo.InventoryTarget), so the agent
has no reason to ask the developer for either.
@filippolmt
filippolmt merged commit 3de6c44 into main Nov 11, 2026
2 checks passed
@filippolmt
filippolmt deleted the docs/skill-toolbox-shim branch November 11, 2026 17:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant