Repository navigation
Build and audit the DockerCatAgent container foundation - #1
Merged
Merged
Conversation
This was referenced Oct 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Result
Builds a persistent, Docker/Compose Claude Code CLI environment with non-root defaults, optional SSH and optional integrations. The foundation audit and independent reviews corrected SSH startup failures, real interactive PTY login, trust-anchor validation, host-key recovery, callback/key-file inputs and runtime regression coverage. Default Compose still drops all capabilities and publishes no ports.
The foundation, operator documentation and GitHub backlog remain under review; this PR is draft and is not release or deployment approval.
Implementation and scoped corrections
AUDIT_WRITE,SETUID,SETGID,CHOWN,SYS_CHROOTandDAC_READ_SEARCHcapabilities; interactive sessions run as dev.Verification
Current head:
a4898c37f14877ed70eb722b5b523305dda7c7c7Foundation CI run 38594643801: static and build-smoke passed on the exact current head. CI built the image and ran the credential-free regression suite. Job annotations contain only a GitHub runner migration notice, not a warning/failure.
The earlier pre-review local AMD64 audit (Docker 28.4.0 / Compose v2.40.3) passed:
.claude.jsonand.claude/persistence; tmux termination; actual cached rebuild/recreation and independent volumes for a differently named project.Historical pre-review local image:
sha256:6a30b29c00db4de9a635aff38549f86201ca8e761339dfa89e6ddac35063a5fb. Cached rebuild retained this image ID; this was not an upgraded-version migration test. See audit and validation for evidence boundaries.GitHub organization and documentation
Project #2 is canonical; do not create another board. Reading it and the linked repository project is denied by integration permissions, so no board changes are claimed. Description/topics edits and detailed branch-protection inspection were also denied. Native branches report main unprotected.
The separate wiki still contains its original welcome page; this PR's prepared pages were not published.
Remaining acceptance and owner decisions
Foundation is incomplete. Subscription login/state continuity (#4), API-key behavior/exposure (#19), Mem OAuth/grants (#21), ARM64 hardware (#2), real Portainer endpoint (#5), VPN/mobile clients and actual tunnel-device denial (#3) still need manual evidence. Tunnel/Unix-socket restrictions were checked through effective configuration.
No license is approved (#6). Root SSH least privilege, encrypted recovery and supply-chain reproducibility remain later scoped work (#9/#7/#8). Docker administrators can access credential-bearing state; outbound access is available; read-only mounts and tool instructions do not prevent permitted data disclosure.
No merge, release, tag, registry image, production deployment or wiki synchronization occurred. Green CI does not authorize any of them.
Independent SSH/security review remediation (2026-10-14)
a4898c37f14877ed70eb722b5b523305dda7c7c7staticandbuild-smokeboth successful on this head..bash_logoutedge cases; regression now handles real terminal semantics rather than weakening assertions.authorized_keyspermissions documentation and trimmed SSH capabilities; eliminated the privileged chmod of a dev-owned path. Default Docker execution remains non-root and capability-free.docker compose execbehavior, and clarify optional headless OAuth forwarding.Not validated by this CI: live Claude subscription/API login and Mem OAuth, ARM64, actual Portainer deployment, mobile/VPN access, tunnel-device denial and full root-daemon architecture review. The PR remains draft. No merge, release, image publication, or deployment is authorized.
Final targeted review follow-ups (2026-10-14)
ssh-keygen -yoperation; recover missing or empty public-key sidecars through a temporary file and atomic rename, without rotating identity. Runtime regression tests recreate a disposable container after a0644private-key restoration and after an empty.pub, asserting first-start recovery, mode0600, nonempty public key, stable identity and no temporary-file residue.a4898c37f14877ed70eb722b5b523305dda7c7c7. CI run 38594643801 passed static and Docker runtime jobs. This remains a draft PR, pending owner review and merge authorization. Account-backed and cross-platform acceptance work remains open.