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. 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 for the cross-language setup flow.
- Open C++ API for the reference surface.
- Read Stream responses in real-time and Handle approvals and user input for shared runtime behavior.