clawker-socket-server

Overview ¶

socket-forwarder is a multiplexing socket forwarder that runs inside clawker containers. It communicates with the host via stdin/stdout using a simple length-prefixed binary protocol, similar to VS Code's muxrpc approach.

This allows socket forwarding without requiring network access from the container to the host - all communication happens over the docker exec channel.

Build: go build -o socket-forwarder main.go Usage: Launched via `docker exec -i <container> socket-forwarder`

Environment:

• CLAWKER_REMOTE_SOCKETS: JSON array of socket configs, e.g.: [{"path": "/home/claude/.gnupg/S.gpg-agent", "type": "gpg-agent"}]

Protocol:

Message format: [4-byte length][1-byte type][4-byte stream][payload]
Types: DATA=1, OPEN=2, CLOSE=3, PUBKEY=4, READY=5, ERROR=6