Skip to content

docs: correct volume references after the mitmproxy-public split - #104

Merged
shejnowicz merged 1 commit into
masterfrom
docs/97-mitmproxy-public-volume-references
Sep 1, 2026
Merged

shejnowicz merged 1 commit into
masterfrom
docs/97-mitmproxy-public-volume-references

Conversation

@shejnowicz

Copy link
Copy Markdown
Collaborator

Follow-up to #97 (which fixed #25). No open issue tracks this, so there is no close keyword.

Summary

#97 split the agent-facing files onto a separate mitmproxy-public volume so the agent can no longer read the CA private key, but the README was left describing the pre-split layout. Spotted while integration-testing #101, which touches sandcat.env generation.

Stale claims corrected:

  • sandcat.env was described as living on mitmproxy-config at /home/mitmproxy/.mitmproxy/sandcat.env; the addon actually writes /mitmproxy-public/sandcat.env (SANDCAT_ENV_PATH).
  • Same for cursor-cli-config.json — now /mitmproxy-public/.
  • "App containers mount mitmproxy-config read-only at /mitmproxy-config/" — they mount mitmproxy-public at that path. The path prefix inside the agent is unchanged, which is exactly what made this easy to miss; the text now says so explicitly.
  • The volumes diagram showed mitmproxy-ca-cert.pem and sandcat.env inside mitmproxy-config, with the agent reading from it. It now shows both volumes, their real contents, and who mounts which.
  • The compose-agent.yml description and the startup-sequence intro likewise pointed at the wrong volume.

Docs only — no code or template changes.

Verification

  • Every mitmproxy-config / mitmproxy-public mention in the README re-checked against compose-proxy.yml, compose-agent.yml, and the addon's path constants.
  • No test asserts root README content (the two test files matching "README" reference fixtures/pass-cli/README.md and a command-output string).

🤖 Generated with Claude Code

#97 moved the agent-facing files onto a separate `mitmproxy-public` volume
so the agent can no longer read the CA private key (#25), but the README
still described the pre-split layout: it claimed `sandcat.env` lives on
`mitmproxy-config` at `/home/mitmproxy/.mitmproxy/sandcat.env`, showed the
CA cert and `sandcat.env` inside `mitmproxy-config` in the volumes diagram,
and pointed the agent's read-only mount at that volume.

Corrected throughout: the addon writes `/mitmproxy-public/sandcat.env` and
`/mitmproxy-public/cursor-cli-config.json`, the agent mounts
`mitmproxy-public` read-only at `/mitmproxy-config/` (hence paths inside the
agent keep that prefix), and `mitmproxy-config` stays private to mitmproxy
and wg-client. The volumes diagram now shows both volumes and who mounts
which.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@shejnowicz
shejnowicz merged commit cde4f7e into master Sep 1, 2026
3 checks passed
@shejnowicz
shejnowicz deleted the docs/97-mitmproxy-public-volume-references branch September 1, 2026 12:33
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.

security: sharing ~/.mitmproxy to app

1 participant