Usage examples for LocalHarness.
Note: The SDK manages the binary lifecycle automatically. It spawns the binary, performs a pipe-based handshake for secure port assignment and API key exchange, then communicates over WebSocket. You never need to start the binary manually.
# Build the binary (SDK auto-finds ./bin/localharness)
make build
# Set your API key
export GEMINI_API_KEY="your-key-here"Runnable Go programs using the adk package:
| Example | Description | Run |
|---|---|---|
| adk-basic | Simple prompt → response | go run ./examples/adk-basic |
| adk-policy | Declarative permission control | go run ./examples/adk-policy |
| adk-safe-agent | Read-only agent with interactive write approval | go run ./examples/adk-safe-agent |
| adk-budget-logging | Custom logging and session token budgets | go run ./examples/adk-budget-logging |
| adk-streaming | Streaming step-by-step output | go run ./examples/adk-streaming |
| adk-structured-prompt | Modular system prompt composition | go run ./examples/adk-structured-prompt |
| adk-planning-mode | Plan-before-act workflow with artifacts | go run ./examples/adk-planning-mode |
| adk-ephemeral-messages | Per-turn directives (security context, language, feature gates) | go run ./examples/adk-ephemeral-messages |
| adk-host-tools | SDK-registered custom tools with auto-dispatch handlers | go run ./examples/adk-host-tools |
| adk-slash-commands | Slash command recommendations (agent suggests, user triggers) | go run ./examples/adk-slash-commands |
| adk-skills-plugins | ADK-injected skills and plugins | go run ./examples/adk-skills-plugins |
| adk-subagents | Custom subagent types with tool-group control | go run ./examples/adk-subagents |
| adk-middleware | Middleware pipeline: logging, token guard, tool selector, retry | go run ./examples/adk-middleware |
| adk-research | Read-only research agent with checkpoints and resume | go run ./examples/adk-research |
| adk-code-review | Code review agent with dynamic tool selection and failover | go run ./examples/adk-code-review |
| adk-subtask | Ergonomic subtask API: sync, async, parallel, model override | go run ./examples/adk-subtask |
| auto-discovery | Auto-discover skills/plugins from workspace .agents/ directory |
go run ./examples/auto-discovery |
| cloudflare-gateway | Route LLM requests through Cloudflare AI Gateway (caching, analytics) | go run ./examples/cloudflare-gateway |
Usage patterns via go run ./cmd/testclient:
| Example | Description |
|---|---|
| basic-gemini | Simple prompt with Gemini |
| openai-ollama | Local LLM via Ollama |
| tool-usage | Agentic file operations |
| custom-system-prompt | Custom system instructions |
| compaction | Context window compaction |
| Example | Description |
|---|---|
| host-tools | Wire protocol reference for SDK-registered custom tools |