Claude Agent SDK Demos

What it does

• Eight official demos: email-agent (an in-development IMAP email assistant with inbox display and agentic search), research-agent (subtopics spawn parallel web-searching researchers, then synthesis), simple-chatapp (React + Express + WebSocket streaming), resume-generator, excel-demo, hello-world, hello-world-v2, and ask-user-question-previews
• hello-world-v2 demonstrates the V2 Session API (unstable_v2_*): separate send()/stream() calls instead of a single query() generator, with multi-turn conversation and session persistence
• ask-user-question-previews renders answer options as HTML preview cards (previewFormat: 'html' plus canUseTool over WebSocket) with plan-mode steering
• Shows whole-app patterns — session persistence, multi-agent orchestration, human-in-the-loop — the app-pattern counterpart to the API-focused claude-quickstarts

When to use it

Read these before writing your own Agent SDK app: pick the demo matching your pattern (chat with persistence, multi-agent research, guided UX) and study the wiring.

Getting started

git clone https://github.com/anthropics/claude-agent-sdk-demos.git
cd claude-agent-sdk-demos
cd email-agent  # or any other demo, then follow its README

Prerequisites: the Bun runtime (or Node.js 18+) and an Anthropic API key.

Things to know

Carries a top-of-README warning: demos are intended for local development only and should NOT be deployed to production or used at scale. hello-world-v2 exercises an explicitly unstable API surface (unstable_v2_*).