# ClaudeWrapper v0.8.0 - Table of Contents

> Elixir wrapper for the Claude Code CLI

## Pages

- [ClaudeWrapper](readme.md)
- [Changelog](changelog.md)

## Modules

- [ClaudeWrapper.Agents](ClaudeWrapper.Agents.md): File-backed read/write access to Claude Code's on-disk **agent**
definitions.
- [ClaudeWrapper.Agents.Definition](ClaudeWrapper.Agents.Definition.md): Full agent definition returned by `ClaudeWrapper.Agents.get/2`.
- [ClaudeWrapper.Agents.Summary](ClaudeWrapper.Agents.Summary.md): Lightweight metadata for one agent definition, returned by
`ClaudeWrapper.Agents.list/1`.
- [ClaudeWrapper.Auth](ClaudeWrapper.Auth.md): Detect which auth strategy the Claude Code CLI will use, and classify
auth-related CLI failures.
- [ClaudeWrapper.Auth.Summary](ClaudeWrapper.Auth.Summary.md): Snapshot of auth-relevant environment state.
- [ClaudeWrapper.Budget](ClaudeWrapper.Budget.md): Cumulative USD budget tracker with threshold callbacks.
- [ClaudeWrapper.CliVersion](ClaudeWrapper.CliVersion.md): Parse and compare the `claude` CLI's reported version.
- [ClaudeWrapper.Commands.AutoMode](ClaudeWrapper.Commands.AutoMode.md): Auto-mode classifier inspection commands.
- [ClaudeWrapper.Commands.Install](ClaudeWrapper.Commands.Install.md): Install a Claude Code native build.
- [ClaudeWrapper.Commands.Project](ClaudeWrapper.Commands.Project.md): Project state management commands.
- [ClaudeWrapper.Commands.Update](ClaudeWrapper.Commands.Update.md): Check for CLI updates and install if available.
- [ClaudeWrapper.Conversation](ClaudeWrapper.Conversation.md): Host-side bookkeeping wrapper over a `ClaudeWrapper.DuplexSession`.
- [ClaudeWrapper.DangerousClient](ClaudeWrapper.DangerousClient.md): Opt-in wrapper for permission-bypass queries.
- [ClaudeWrapper.History](ClaudeWrapper.History.md): Read-side access to Claude Code's on-disk session history.
- [ClaudeWrapper.History.ProjectSummary](ClaudeWrapper.History.ProjectSummary.md): Summary of one project directory under the history root.
- [ClaudeWrapper.History.SessionLog](ClaudeWrapper.History.SessionLog.md): A fully parsed session: an ordered list of `t:ClaudeWrapper.History.entry/0`.

- [ClaudeWrapper.History.SessionSummary](ClaudeWrapper.History.SessionSummary.md): Summary of one session `.jsonl` file.
- [ClaudeWrapper.Jobs](ClaudeWrapper.Jobs.md): Read-side access to Claude Code's on-disk **background-job** state.
- [ClaudeWrapper.Jobs.Event](ClaudeWrapper.Jobs.Event.md): One timeline event from a job's `timeline.jsonl`.
- [ClaudeWrapper.Jobs.Job](ClaudeWrapper.Jobs.Job.md): Full job record returned by `ClaudeWrapper.Jobs.get/2`.
- [ClaudeWrapper.Jobs.Summary](ClaudeWrapper.Jobs.Summary.md): Cheap metadata view of one background job, returned by
`ClaudeWrapper.Jobs.list/1`. Stripped of the timeline.
- [ClaudeWrapper.Settings](ClaudeWrapper.Settings.md): Read-side access to Claude Code's on-disk **settings** files.
- [ClaudeWrapper.Skills](ClaudeWrapper.Skills.md): Read-side access to Claude Code's on-disk **skill** definitions.
- [ClaudeWrapper.Skills.Skill](ClaudeWrapper.Skills.Skill.md): Full skill record returned by `ClaudeWrapper.Skills.get/2`.
- [ClaudeWrapper.Skills.Summary](ClaudeWrapper.Skills.Summary.md): Lightweight metadata for one skill, returned by
`ClaudeWrapper.Skills.list/1`.
- [ClaudeWrapper.ToolPattern](ClaudeWrapper.ToolPattern.md): Tool permission patterns for `--allowed-tools` / `--disallowed-tools`.
- [ClaudeWrapper.Worktrees](ClaudeWrapper.Worktrees.md): Read-side introspection for git worktrees.
- [ClaudeWrapper.Worktrees.Worktree](ClaudeWrapper.Worktrees.Worktree.md): One git worktree as reported by `git worktree list --porcelain`.

- Long-lived sessions
  - [ClaudeWrapper.DuplexIEx](ClaudeWrapper.DuplexIEx.md): Interactive helpers for driving `ClaudeWrapper.DuplexSession` from IEx.
  - [ClaudeWrapper.DuplexSession](ClaudeWrapper.DuplexSession.md): Long-lived `claude` session over the CLI's stream-json duplex protocol.

- One-shot / per-call
  - [ClaudeWrapper](ClaudeWrapper.md): Elixir wrapper for the Claude Code CLI.
  - [ClaudeWrapper.IEx](ClaudeWrapper.IEx.md): Interactive helpers for conversational use in IEx.
  - [ClaudeWrapper.Query](ClaudeWrapper.Query.md): Query command -- the primary interface for executing prompts.
  - [ClaudeWrapper.Session](ClaudeWrapper.Session.md): Multi-turn session management.
  - [ClaudeWrapper.SessionServer](ClaudeWrapper.SessionServer.md): GenServer wrapper for long-running multi-turn sessions.

- Shared infrastructure
  - [ClaudeWrapper.Config](ClaudeWrapper.Config.md): Shared client configuration for the Claude CLI.
  - [ClaudeWrapper.McpConfig](ClaudeWrapper.McpConfig.md): Programmatic builder for `.mcp.json` configuration files.
  - [ClaudeWrapper.Result](ClaudeWrapper.Result.md): Result from a completed query execution.
  - [ClaudeWrapper.Retry](ClaudeWrapper.Retry.md): Retry policy with exponential backoff for query execution.
  - [ClaudeWrapper.StreamEvent](ClaudeWrapper.StreamEvent.md): A single event from the Claude CLI's NDJSON streaming output.
  - [ClaudeWrapper.Telemetry](ClaudeWrapper.Telemetry.md): `:telemetry` events emitted by ClaudeWrapper.

- CLI subcommand wrappers
  - [ClaudeWrapper.Command](ClaudeWrapper.Command.md): Behaviour for CLI commands.
  - [ClaudeWrapper.Commands.Agents](ClaudeWrapper.Commands.Agents.md): `claude agents` command -- lists configured agents.

  - [ClaudeWrapper.Commands.Auth](ClaudeWrapper.Commands.Auth.md): Authentication commands -- login, logout, status, token setup.

  - [ClaudeWrapper.Commands.Doctor](ClaudeWrapper.Commands.Doctor.md): `claude doctor` command -- checks CLI health.

  - [ClaudeWrapper.Commands.Marketplace](ClaudeWrapper.Commands.Marketplace.md): Plugin marketplace management commands.
  - [ClaudeWrapper.Commands.Mcp](ClaudeWrapper.Commands.Mcp.md): MCP (Model Context Protocol) server management commands.
  - [ClaudeWrapper.Commands.Plugin](ClaudeWrapper.Commands.Plugin.md): Plugin management commands.
  - [ClaudeWrapper.Commands.Version](ClaudeWrapper.Commands.Version.md): `claude --version` command.

- Exceptions
  - [ClaudeWrapper.Error](ClaudeWrapper.Error.md): Canonical error type for ClaudeWrapper.

