These are runnable applications, not disconnected snippets. Start with a production example when you want to understand how Kuralle's agent, policy, persistence, workspace, skills, transports, and operating boundaries compose. Use a playground when you want to isolate one mechanism.
For a customer-facing web application, start with the Customer Support Agent. Its brand and reviewed help corpus live in one validated config, while the same Pi-backed agent runs with PostgreSQL on Vercel or one SQLite-backed Durable Object per conversation on Cloudflare.
For retrieval-led shopping and approval-gated checkout, follow Build an Agentic Commerce Assistant. It shows the same agent on Node/Bun and Cloudflare while keeping search, commercial truth, durable coordination, and payment authority on separate substrates.
Before running an example, clone the monorepo and install once:
git clone https://github.com/kuralle/kuralle-agents.gitcd kuralle-agentsbun installProvider-backed examples read credentials from the repository root .env or their local .env.example. Focused deterministic tests do not require a model key.
Reference systems
Complete applications with explicit data ownership, durable effects, failure boundaries, tests, and operating notes.
Audits a real Git repository, runs release gates, persists a revision-bound candidate, and creates an approval-gated GitHub draft without exposing a shell or gaining tag and publication authority.
bun run --cwd apps/examples/release-governance-agent chat Finds products through Samesake, revalidates price and stock in Porulle, and pauses an idempotent Stripe checkout for explicit approval across Node/Postgres and Cloudflare Durable Objects.
bun run --cwd apps/examples/agentic-commerce-assistant node Ships one Pi-backed support core across Vercel/Postgres and Cloudflare Durable Objects, with config-owned knowledge, signed identity, approval-gated writes, grounding validation, and human escalation.
bun run --cwd apps/examples/customer-support-agent dev Runs the same safe pharmacy agent on Next.js/Vercel and a Cloudflare Durable Object with per-session workspaces, progressive skills, and hosted CLI access.
bun run --cwd apps/examples/pharmacy-rx-agent dev A Next.js workbench backed by PostgreSQL and pgvector, with signed identity, hybrid retrieval, persistent memory, and approval-gated account operations.
bun run --cwd apps/examples/postgres-hacker-starter db:up && bun run --cwd apps/examples/postgres-hacker-starter dev Turns local Markdown sources and filesystem skills into revisioned drafts with deterministic style checks, explicit approvals, and conflict-safe publication.
bun run --cwd apps/examples/content-agent chat A terminal healthcare operator for appointment, billing, and escalation work with authenticated records, durable SQLite state, and bounded actions.
bun run --cwd apps/examples/healthcare chat Handles verified bookings and hotel operations against a real SQLite service layer and policy handbook, with privacy and emergency boundaries.
bun run --cwd apps/examples/hotel-receptionist chat Focused proof
Smaller runnable surfaces for studying one substrate, transport, retrieval strategy, or compatibility boundary.
Three-tier compiled, cached, and hybrid retrieval with multi-hop decomposition, reranking, quality checks, specialist routing, and benchmarks.
bun run --cwd apps/playground/acme-support-agent ingest && bun run --cwd apps/playground/acme-support-agent cli End-to-end ingestion and vector retrieval with interchangeable in-memory, PostgreSQL/pgvector, and Redis Search stores plus Hono SSE/WebSockets.
bun run --cwd apps/playground/rag-demo cli A compact restaurant knowledge agent where the model ranks a bounded corpus directly—useful for comparing CAG with vector retrieval.
bun run --cwd apps/playground/cag-demo cli A routed support conversation exported through Kuralle OTLP spans and the Langfuse OpenTelemetry processor, with a credential-free smoke lane.
bun run --cwd apps/playground/langfuse-demo run Runs every Core flow example plus workspace, skill, OKF, parallel-tool, trace, and latency assertions through both Pi and the AI SDK driver.
bun run --cwd apps/playground/pi-driver-stress smoke A persistent Kuralle workspace inside a real Cloudflare AIChatAgent Durable Object using its own SQLite storage.
The same SqlFileSystem contract on a stateless serverless platform, persisted through a fetch-only libSQL/Turso backend.
A focused Cloudflare playground for multimodal prescription intake and durable payment-signal resume across web chat and WhatsApp.
Production examples own a full user journey and document their trust boundary, state substrate, tests, and operating procedure. Playgrounds are intentionally narrower; they prove portability or make one tradeoff measurable. A playground can be deployed, but it should not be mistaken for a production contract without adding identity, authorization, retention, and operational ownership appropriate to your application.
All examples use Kuralle primitives directly. They do not introduce a second agent runtime or bypass Kuralle's tool policy, durable journal, session state, or stream contract.