anil.recoil.org / slop
My agentic slop goes here. Not intended for anyone else!
fork atom
slop / claudeio / README.md
at main 1.4 kB view raw view code

ClaudeIO - OCaml Eio Library for Claude Code CLI#

An OCaml library that provides high-quality Eio-style bindings for the Claude Code CLI, enabling programmatic interaction with Claude through JSON streaming.

Overview#

ClaudeIO wraps Claude Code CLI invocations in an idiomatic OCaml Eio interface, leveraging:

  • JSON input/output streaming modes of the CLI
  • Ezjsonm for JSON message handling
  • Eio abstractions including Buf_read and Seq for efficient streaming

Features#

  • Streaming JSON Interface: Communicate with Claude using structured JSON messages
  • Eio Integration: Built on modern OCaml concurrency primitives
  • Type-safe API: Strongly typed OCaml interface for Claude interactions
  • Efficient Buffering: Uses Eio's buffer management for optimal performance

Installation#

opam install claudeio

Usage#

open Eio
open Claudeio

let main ~env =
  let claude = Claude.create ~env in
  Claude.query claude ~prompt:"Your question here"
  |> Seq.iter (fun response -> 
    Format.printf "Claude: %s\n" (Claude.Response.to_string response))

Known Issues#

⚠️ Permissions Support: The permissions functionality is temporarily broken and awaiting a fix from Anthropic. This feature will be restored in a future update.

Requirements#

  • OCaml >= 5.0
  • Eio >= 1.0
  • Ezjsonm >= 1.3
  • Claude Code CLI installed and configured

License#

See LICENSE file for details.