Quickstart
Install the SDK, point it at a repo, and stream what the agent is doing in real time from your host language.
The examples below use the current CLI-backed SDK flow where each wrapper starts or controls the Autohand runtime, streams events, and returns a final run result.
1. Choose your language TypeScript
Pick the SDK you want to start with. The install command and first prompt example update to match.
2. Prerequisites
- Node.js or Bun.
- The Autohand CLI config in
~/.autohand/config.json. - A repo you want the agent to work in.
- Python 3.10 or newer.
- The Autohand CLI config in
~/.autohand/config.json. - A repo you want the agent to work in.
- Go 1.21 or newer.
- The Autohand CLI config in
~/.autohand/config.json. - A repo you want the agent to work in.
- Java 21 or newer.
- Maven 3.9 or newer.
- The Autohand CLI config in
~/.autohand/config.json.
- Swift 6.0 or newer.
- A provider key such as OpenAI or OpenRouter for the native Swift SDK.
- A repo you want the agent to work in.
- Rust 1.80 or newer.
- Tokio runtime.
- Autohand CLI installed, authenticated, and configured.
- Ruby 3.2 or newer.
- Bundler.
- Autohand Code CLI installed with
bundle exec autohand-sdk install-clior supplied withcli_path:.
- .NET 8 or newer.
- Autohand CLI installed, authenticated, and configured.
- Optional
AUTOHAND_CLI_PATHfor local CLI builds.
- C++20 compiler.
- CMake 3.22 or newer.
- Autohand CLI installed, authenticated, and configured.
3. Install the SDK
4. Configure the runtime
The CLI-backed SDKs read provider settings from ~/.autohand/config.json. A minimal OpenRouter config looks like this:
The Swift SDK is provider-native, so you pass the provider directly in code.
5. Run your first prompt
6. Next moves
- Go to Handle approvals and user input when you need human review in the loop.
- Open the language guides: TypeScript, Python, Go, Java, Swift, Rust, Ruby, C#/.NET, C++.
- Use the streaming docs next if you are building a terminal UI, dashboard, or chat surface around the SDK.