Examples
Runnable agents demonstrating fabric-harness features and deploy targets.
Every example below is a self-contained workspace under examples/ in the restricted
Fabric Harness source repository. You can evaluate the public
packages without repository access by generating a project first.
If you are learning the framework rather than looking up one integration, follow the complete learning path. It orders the examples by lifecycle, capabilities, governance, durability, delivery, deployment, and operations.
For the exact current package scripts, expected proof, shared failure behavior, and cleanup contract for every maintained workspace, use Runnable examples.
Quickstart
npx --yes @fabric-harness/cli@latest init harness-example
cd harness-example
npm install
npx fh agents
npx fh run JOB_NAME --mockThe table links open the source-access explanation. Authorized customers and partners can request repository access there to run the exact monorepo fixtures.
By feature
| Example | What it shows | Deploy target |
|---|---|---|
hello-world | Bare minimum: one agent, one prompt. | Node |
minimal | Smallest headless finite job. | Node |
with-config | Workspace-level config.ts overrides. | Node |
with-approval | Imperative approval gate via session.approval.request(). | Node |
with-checkpoint | Snapshot a session, restart from a labeled checkpoint. | Node |
with-skill | session.skill() invocation with typed result. | Node |
with-task | Long-running tasks with checkpoints. | Node / Temporal |
with-tools | Custom tool schemas. | Node |
with-finish-tool | Schema-validated finish and explicit give_up result tools. | Node |
with-local-shell | LocalSandboxEnv shell tool. | Node |
dynamic-agent | Persistent state, hooks, capability/model changes, streamed data, and finish guards. | Node |
react-chat | Persistent chat and finite runs through the public client and React protocol. | Node / Vite |
Deploy targets
| Example | Target |
|---|---|
with-docker | Docker sandbox |
with-kubernetes | Kubernetes pod |
with-cloudflare-sandbox | Cloudflare Containers sandbox |
with-cloudflare-shell-workspace | Cloudflare Computer Workspace with just-bash and standard Harness tools |
with-cloudflare-workers-ai | Cloudflare Workers AI binding (zero-API-key) |
with-azure | Azure ACA / AKS |
with-daytona | Daytona remote sandbox |
with-e2b | E2B isolated sandbox with timeout and cleanup |
with-modal | Modal sandbox |
with-vercel-sandbox | Vercel Sandbox with cancellation and cleanup |
with-s3-source | Mount an S3 prefix as a filesystem source |
with-temporal | Durable Temporal worker |
with-databricks-simple | Credential-free Databricks authoring smoke with a mocked model provider |
with-databricks-revenue-ops | Golden Databricks App workload: OBO, Genie, SELECT-only SQL, exact Job approval, Lakebase recovery, and optional Temporal |
with-databricks | Governed SQL/Unity Catalog analytics copilot; live Databricks required |
with-databricks-rag | AI Search plus Unity AI Gateway RAG; live Databricks required |
with-databricks-dataeng | Lakeflow pipeline operations; live Databricks required |
with-databricks-cost-attribution | System Tables cost attribution with a generated Databricks SDK client |
with-analytics-copilot | Credential-free proof of SELECT-only SQL and analytics steward policy; README includes live SP and OBO wiring |
with-databricks-managed-mcp | Managed MCP discovery, rotating OBO auth, fail-closed effects, and governed lineage |
with-databricks-compute | SQL Warehouse, Jobs, notebook, and App execution choices |
with-databricks-agent-service | Unity Catalog Agent Services registration, grants, discovery, and teardown |
with-databricks-authoring-admin | Approval-bound Serving, Unity Catalog, Workspace, and secret-reference administration |
with-databricks-genie-authoring | Governed Genie management plus create → grant → Agent Mode invoke → exact cleanup |
with-databricks-jobs-authoring | Policy-bound multi-task Jobs lifecycle and cleanup |
with-databricks-bundle-deploy | Governed checked-in Asset Bundle validate/deploy/run/destroy with fingerprint drift detection |
with-databricks-rag-admin | AI Search endpoint/index lifecycle plus governed query verification |
with-databricks-app-resources | Native Databricks App resources, least-privilege bindings, preflight, and Bundle cleanup |
with-databricks-appkit-interop | AppKit Beta agent invoking a read-only governed Harness tool through MCP |
with-postgres-store | Postgres session persistence |
with-slack-channel | Verified Slack event ingress to a persistent agent |
with-channel-adapters | All 18 maintained channel adapters with signed ingress and governed replies |
agent-registry | Vertical-neutral definitions, immutable versions, capability grants, budgets, and autonomy ceilings |
with-signal-messages | Out-of-band typed signal messages |
with-packaged-skills | Packaged skills and lazy resource loading |
finite-jobs | Typed parent/child jobs, middleware, run identity, and idempotent nested invocation |
scheduled-jobs | Node cron scheduling, Cloudflare Cron build output, and HA lease guidance |
database-persistence | One config selecting local libSQL, Turso, MySQL, or MongoDB unified persistence |
application-routes | Authenticated Fetch routes and middleware composing durable dispatch and finite jobs |
Production and operations patterns
| Example | What it proves |
|---|---|
private-networking | Deny-by-default Docker and Kubernetes egress with an explicit proxy path. |
with-observability | Redacted, correlated Braintrust, Jetty, Sentry, OpenTelemetry, and evaluation evidence. |
operational-slos | Stable operational metrics, policy evaluation, and importable Prometheus/Grafana assets. |
Realistic use cases
| Example | What it does |
|---|---|
code-review | Review a PR diff, produce inline comments. |
issue-triage-ci | GH Actions agent that triages new issues. |
bug-reproducer | Generate a minimal reproduction from a bug report. |
data-analyst | Mount a CSV; answer SELECT-style questions. |
support-agent | KB-grounded customer support. |
support-agent-cloudflare-r2 | Same, deployed on Cloudflare with R2-backed KB. |
support-agent-foundry | Same, on Azure AI Foundry Hosted Agent. |
changelog-writer | Drafts release notes from git log. |
incident-runbook | Runs a runbook against an alert payload. |
api-docs-generator | Generate API docs from source. |
schema-migration | Plan a database schema migration. |
test-generator | Generate Vitest tests from source. |
dependency-auditor | Audit npm dependencies for risk. |
coding-agent-lite | Minimal Claude-Code-style coding agent. |
remote-coding-agent | Coding agent in a remote sandbox. |
release-notes | Compose release notes from PRs and commits. |
voice-data-collector | Voice intake — Realtime API + bring-your-own audio I/O. |
Need a connector?
When no example covers the provider you want, scaffold one in your own project:
fh add daytona | claude
fh add https://your-provider.example.com --category sandbox | claude
fh add daytona --pr # open a draft PR with a stubSee the connector catalog for the spec.
What "runnable" means
Credential-free examples demonstrate local wiring and deterministic model behavior. Provider-backed examples require the named provider, credentials, permissions, and the smoke test documented by that integration. Follow the Databricks deployment guide for workspace identity and certification.
Each maintained example must identify prerequisites and authentication, a run command, an expected observable result, explicit failure behavior, and cleanup. The examples catalog is checked against the actual top-level workspaces so a shipped example cannot silently disappear from documentation.
Follow-along guides
- Enterprise controls — combine policy, approvals, tools, and budgets.
- Build and run artifacts — package finite jobs and persistent agents.
- Databricks App tutorial — scaffold, mock-test, build, deploy, and add Lakebase.
The credential-free Databricks examples cover the authoring flow. Configure the credentialed suite to verify Lakebase OAuth database credential exchange, App deployment, workspace permissions, and restart recovery in the target workspace.
Use Cases
Ten Fabric Harness agents you can build today, across the software development lifecycle — issue triage, PR review, changelog drafting, test generation, dependency audit, migrations, API docs, bug repro, release notes, and incident runbooks. Every example shows both minimal and complete entrypoint forms.
Runnable examples
Runnable commands, expected proof, failure behavior, and cleanup for every maintained Fabric Harness example.