# Claude Code inbox socket: documenting session messages and delivery

> The Claude Code inbox-socket project documents the internal session messaging protocol carried over a Unix socket or Windows named pipe. It describes JSON-line frames, transport, receipts and delivery behavior, and supplies client examples and conformance checks against installed Claude Code versions.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/cacarico/claude-code-inbox-socket-spec>
- Primary source: <https://github.com/cacarico/claude-code-inbox-socket-spec/blob/19e98c369cdb41d8546b48d65ad8662f6b0c6806/README.md>
- Catalog page: <https://awesomerea.org/resources/claude-code-inbox-socket-case/>
- Record JSON: <https://awesomerea.org/resources/claude-code-inbox-socket-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/claude-code-inbox-socket-case/index.md)

## Requirements & limits

- **Prerequisites:** An installed Claude Code version is needed for live conformance checks; those checks start temporary sessions and incur model usage.
- **Limits:** The internal frame format may change between releases.
- **License:** MIT license.

## Primary sources

1. <https://github.com/cacarico/claude-code-inbox-socket-spec/blob/19e98c369cdb41d8546b48d65ad8662f6b0c6806/README.md>
2. <https://github.com/cacarico/claude-code-inbox-socket-spec/blob/19e98c369cdb41d8546b48d65ad8662f6b0c6806/CHANGELOG.md>

## More in Protocols

- [Fujitsu FGL Type A Bus Protocol: decoding an air-conditioner wired remote](https://awesomerea.org/resources/fujitsu-fgl-type-a-bus-case/index.md) · Case study
- [UniFi Protect: reconstructing siren and AI Horn audio control](https://awesomerea.org/resources/unifi-protect-audio-control-case/index.md) · Case study
- [sr16-bridge: reconstructing SR16 smart-ring BLE history sync](https://awesomerea.org/resources/sr16-bridge-case/index.md) · Case study
- [alpha1s: reconstructing UBTECH Alpha 1S Bluetooth control](https://awesomerea.org/resources/alpha1s-sdk-case/index.md) · Case study
- [Daybreak: rebuilding COLMI R09 BLE communication for an offline ring client](https://awesomerea.org/resources/daybreak-colmi-r09-case/index.md) · Case study
- [USB-Endoscope: reconstructing Usee Plus USB video streaming](https://awesomerea.org/resources/usb-endoscope-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.