---
title: "C++ SDK Code Agent SDK"
source: https://docs.autohand.ai/agent-sdk/cpp
---

# C++ SDK

The C++20 SDK wraps the Autohand CLI in JSON-RPC mode and exposes a small host-friendly API with CMake integration, typed event helpers, and high-level agent runs.

**Repository:** [autohandai/code-agent-sdk-cpp](https://github.com/autohandai/code-agent-sdk-cpp). This SDK is in beta while the Agent SDK APIs stabilize. Pin commits or package versions in production.

## Requirements

-   C++20 compiler.
-   CMake 3.22 or newer.
-   Autohand CLI installed, authenticated, and configured.
-   POSIX runtime for the initial transport implementation.

## Install

## Run your first agent

Start with the high-level agent API when you want the SDK to own the run lifecycle and final result collection.

## API shape

-   CMake target: \`autohand::sdk\`.
-   Value-oriented \`autohand::Config\` setup.
-   High-level \`autohand::Agent\` and \`autohand::Run\` workflow.
-   Low-level \`autohand::AutohandSdk\` methods for direct runtime control.

## Low-level control

Use \`AutohandSdk\` when your native host needs to toggle plan mode, stream events directly, or own JSON-RPC request timing.

## Next steps

-   Use [Quickstart](quickstart.html) for the cross-language setup flow.
-   Open [C++ API](cpp-api.html) for the reference surface.
-   Read [Stream responses in real-time](io/streaming.html) and [Handle approvals and user input](io/approvals.html) for shared runtime behavior.