···11+# ClaudeIO - OCaml Eio Library for Claude Code CLI
22+33+An OCaml library that provides high-quality Eio-style bindings for the Claude Code CLI, enabling programmatic interaction with Claude through JSON streaming.
44+55+## Overview
66+77+ClaudeIO wraps Claude Code CLI invocations in an idiomatic OCaml Eio interface, leveraging:
88+- JSON input/output streaming modes of the CLI
99+- Ezjsonm for JSON message handling
1010+- Eio abstractions including `Buf_read` and `Seq` for efficient streaming
1111+1212+## Features
1313+1414+- **Streaming JSON Interface**: Communicate with Claude using structured JSON messages
1515+- **Eio Integration**: Built on modern OCaml concurrency primitives
1616+- **Type-safe API**: Strongly typed OCaml interface for Claude interactions
1717+- **Efficient Buffering**: Uses Eio's buffer management for optimal performance
1818+1919+## Installation
2020+2121+```bash
2222+opam install claudeio
2323+```
2424+2525+## Usage
2626+2727+```ocaml
2828+open Eio
2929+open Claudeio
3030+3131+let main ~env =
3232+ let claude = Claude.create ~env in
3333+ Claude.query claude ~prompt:"Your question here"
3434+ |> Seq.iter (fun response ->
3535+ Format.printf "Claude: %s\n" (Claude.Response.to_string response))
3636+```
3737+3838+## Known Issues
3939+4040+⚠️ **Permissions Support**: The permissions functionality is temporarily broken and awaiting a fix from Anthropic. This feature will be restored in a future update.
4141+4242+## Requirements
4343+4444+- OCaml >= 5.0
4545+- Eio >= 1.0
4646+- Ezjsonm >= 1.3
4747+- Claude Code CLI installed and configured
4848+4949+## License
5050+5151+See LICENSE file for details.