Devcontainers

Mon, 01 Jan 0001 00:00:00 +0000

AI agents inside devcontainers need access to issue trackers, Notion, Figma, and Amplitude, but credentials should stay on the host. human solves this with a daemon that forwards CLI commands from the container to the host.

Architecture

[Devcontainer]                          [Host]
human jira issues list                  human daemon (:19285)
    |  TCP                                  |  (executes command with
    └───── :19285 ──────────────────────────┘    host credentials)

The daemon also runs a chrome proxy on :19286 for Chrome Bridge support, an HTTPS proxy on :19287 for outbound traffic filtering, and a FUSE .env filter that hides secrets from the agent.

Chrome Bridge

Mon, 01 Jan 0001 00:00:00 +0000

The Chrome Bridge enables claude --chrome to work inside devcontainers. Claude Code’s Chrome integration uses Chrome’s native messaging protocol to communicate with the browser extension, which does not work from inside a container because Chrome runs on the host.

Architecture

[Devcontainer]                              [Host]
Claude Code --chrome                        Chrome + Extension
    |  (Unix socket)                            ^  (native messaging)
human chrome-bridge                         human daemon
    |  TCP (:19286)                             ^  (SocketRelay)
    └──────────── TCP tunnel ───────────────────┘

How it works

human daemon start on the host starts the daemon (:19285), chrome proxy (:19286), and a SocketRelay that listens on a Unix socket in /tmp/claude-mcp-browser-bridge-<username>/
human chrome-bridge in the container creates a Unix socket at the same path that Claude Code uses to discover the MCP browser bridge
When Claude Code connects to the socket, the bridge tunnels traffic over TCP to the daemon’s chrome proxy
The daemon pairs the connection with a Chrome native messaging connection via the SocketRelay

Host setup

Start the daemon on your host machine:

Infrastructure on human - The AI dev rig for AI coding agents

Devcontainers

Architecture

Chrome Bridge

Architecture

How it works

Host setup