> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nika.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

> Start with reproducible offline workflows, then configure the models and services a larger example needs.

Start with [offline examples](https://docs.nika.sh/examples/offline.md): known inputs, exact
outputs, no provider key and no external services. The broader gallery
contains workflows with their own model, file and service requirements.
Inspect those prerequisites and permissions before running them.

The binary also includes a rehearsal gallery:

```bash theme={"system"}
nika try 01-hello                    # the mock rehearsal · zero keys · nothing written
nika compile hello hello.nika        # write the offline lesson at an explicit destination
```

`nika try` previews an example on the mock model with zero setup: zero keys
and no model call. The mock replaces the model, not the network: an example
that fetches still reaches its host, and `nika try` names those hosts
(`may reach: …`) before the run. `nika compile`
writes only a Ready candidate to an explicit destination; showcase jobs
on these pages are copied from the YAML, not instantiated by a showcase
slug. `nika compile --list` names exact skeletons. Unknown intent stays
incomplete and does not pick a substitute.

<video autoPlay muted loop playsInline controls poster="/images/posters/workflow-gallery.png" aria-label="The gallery nika try lists: a numbered learning path and a shelf of ready-made jobs" alt="The gallery nika try lists: a numbered learning path and a shelf of ready-made jobs">
  <source src="https://mintcdn.com/supernovae-acdf3706/3tG2rJOQxMP3h2LO/videos/workflow-gallery.webm?fit=max&auto=format&n=3tG2rJOQxMP3h2LO&q=85&s=dcce1ec6bbb15ba353664ddde8d00883" type="video/webm" />

  <source src="https://mintcdn.com/supernovae-acdf3706/3tG2rJOQxMP3h2LO/videos/workflow-gallery.mp4?fit=max&auto=format&n=3tG2rJOQxMP3h2LO&q=85&s=4fad3497f5a33a172ea1ab259f088ead" type="video/mp4" />
</video>

**Start from a workflow.** Run `nika try` with no argument to see the gallery built into the binary: a numbered learning path and a shelf of ready-made jobs, each marked with the verbs it uses. `nika try <name>` previews one on the mock model. *The listing is captured from the real CLI on nika 0.121.0.*

The YAML you read here is projected verbatim from
[`nika-spec/examples/`](https://github.com/supernovae-st/nika-spec/tree/main/examples),
where each file passes the same conformance gate as the spec's own test
suite. That validates the file against that contract; it does not prove
that an external integration is configured or that a model will produce
a useful result. A mock rehearsal proves neither a live integration nor
an AI answer.

Together with the numbered learning path that `nika try` lists, these
workflows exercise **all 30 builtins** and the
4 verbs. Each job page ends with a **Run it** section: the
mock rehearsal, the sample files to download, and what the real run needs.

## How to read a workflow diagram

Tasks are colored by verb, the same palette everywhere in the Nika
universe:

```mermaid theme={"system"}
flowchart LR
  A["infer · call a model"]:::infer --> B["exec · run a process"]:::exec
  B --> C["invoke · call a tool"]:::invoke --> D["agent · drive a loop"]:::agent
  classDef infer fill:#5b8cff22,stroke:#5b8cff,color:#5b8cff
  classDef exec fill:#ff7a3c22,stroke:#ff7a3c,color:#ff7a3c
  classDef invoke fill:#22d3ee22,stroke:#22d3ee,color:#22d3ee
  classDef agent fill:#b07bff22,stroke:#b07bff,color:#b07bff
```

## T1 · Starters

Small files: one chain, one diamond or one small fan-out. You can run one
of these in your first five minutes.

> [card] [Standup digest](https://docs.nika.sh/examples/standup-digest.md)
>
> **Engineering**: your standup note, written from what you actually
> committed yesterday.

> [card] [Meeting actions](https://docs.nika.sh/examples/meeting-actions.md)
>
> **Every office**: transcript in, tracker-ready typed action items
> out.

> [card] [Price watch](https://docs.nika.sh/examples/price-watch.md)
>
> **E-commerce**: a price-drop alert with zero model calls.

> [card] [OG images](https://docs.nika.sh/examples/og-images.md)
>
> **Marketing**: brief in, OG variants on disk + a provenance
> manifest out — offline-testable with the mock provider.

> [card] [Social repurpose](https://docs.nika.sh/examples/social-repurpose.md)
>
> **Marketing**: one post becomes a thread, a LinkedIn post and a
> newsletter blurb, in parallel.

> [card] [Local-first daily brief](https://docs.nika.sh/examples/local-first-daily-brief.md)
>
> **Local-first**: a real fetch, a local model and a verifiable trace,
> with no key anywhere.

> [card] [Image FX batch](https://docs.nika.sh/examples/image-fx-batch.md)
>
> **Creators / Media**: a folder of photos to deterministic art. No
> model, no network.

> [card] [Remove an owned file](https://docs.nika.sh/examples/remove-owned-file.md)
>
> **Any team**: write a scratch file, then remove exactly that file and
> never one the workflow did not create.

## T2 · Chains

Chains of a handful of tasks: structured outputs, human gates, and the
data builtins start pulling their weight.

> [card] [Release notes](https://docs.nika.sh/examples/release-notes.md)
>
> **Engineering / DevRel**: git log → typed notes → CHANGELOG edited
> in place → team pinged.

> [card] [SEO content brief](https://docs.nika.sh/examples/seo-content-brief.md)
>
> **SEO / Content**: a brief grounded in what your competitor
> actually published.

> [card] [Invoice chaser](https://docs.nika.sh/examples/invoice-chaser.md)
>
> **Finance / Freelance**: reminders drafted, and NOTHING goes out
> until a human says yes.

> [card] [Support triage](https://docs.nika.sh/examples/support-triage.md)
>
> **Customer support**: the overnight queue classified, first replies
> drafted, urgent ones escalated.

> [card] [Contract guard](https://docs.nika.sh/examples/contract-guard.md)
>
> **Legal**: clause extraction on a LOCAL model. The contract never
> leaves the machine.

> [card] [ETL quarantine](https://docs.nika.sh/examples/etl-quarantine.md)
>
> **Data engineering**: bad batches degrade to a quarantine file
> instead of killing the pipeline.

> [card] [Release radar](https://docs.nika.sh/examples/release-radar.md)
>
> **DevOps**: dependency feeds diffed against last run. Only the
> NEW ships reach you.

> [card] [Model bench](https://docs.nika.sh/examples/model-bench.md)
>
> **Engineering**: the same question, three local models, one measured
> table.

> [card] [CSV chart report](https://docs.nika.sh/examples/csv-chart-report.md)
>
> **Data**: a CSV becomes a chart and a one-page report. No model.

> [card] [Contact sheet](https://docs.nika.sh/examples/image-compose-sheet.md)
>
> **Creators / Media**: photos and their duotone twins become one contact
> sheet. No model, no image program, no network.

> [card] [Transcript show-notes](https://docs.nika.sh/examples/transcript-shownotes.md)
>
> **Podcasts / Meetings**: a raw transcript becomes typed chapters,
> quotes and a summary in one bounded call.

> [card] [Bookmark triage](https://docs.nika.sh/examples/bookmark-triage.md)
>
> **Research**: a pile of saved URLs becomes one table, dead links
> included.

## T3 · Fan-out

`for_each` over collections the workflow discovers at runtime, with
retry, bounded parallelism and jq fan-ins.

> [card] [Competitor radar](https://docs.nika.sh/examples/competitor-radar.md)
>
> **Strategy / PMM**: everything they shipped last week, read in parallel,
> one Monday brief.

> [card] [Localization factory](https://docs.nika.sh/examples/localization-factory.md)
>
> **Product / i18n**: the whole docs tree translated, voice intact,
> zero copy-paste.

> [card] [Config drift sentinel](https://docs.nika.sh/examples/config-drift-sentinel.md)
>
> **SRE / Platform**: only unsanctioned prod drift wakes anyone. jq
> decides; the model explains.

> [card] [PR review fan-out](https://docs.nika.sh/examples/pr-review-fanout.md)
>
> **Engineering**: a read-only review agent per changed file. A
> swarm with a leash.

> [card] [Resume screener](https://docs.nika.sh/examples/resume-screener.md)
>
> **HR / Recruiting**: one local-model rubric per candidate, ranked
> deterministically. PII stays home.

## T4 · Epic

Multi-stage pipelines: agents under budget, human gates, runs that
report on themselves.

> [card] [Deep research brief](https://docs.nika.sh/examples/deep-research-brief.md)
>
> **Research / VC**: plan → budgeted research agent → synthesis.
> Auditable end to end.

> [card] [Corpus digest](https://docs.nika.sh/examples/corpus-digest.md)
>
> **Research**: a pile of documents becomes one sourced brief, and no
> model window ever holds two of them.

> [card] [Incident war room](https://docs.nika.sh/examples/incident-war-room.md)
>
> **SRE / On-call**: evidence in parallel, a typed timeline, and a
> recovery check before the draft.

> [card] [CEO Monday brief](https://docs.nika.sh/examples/ceo-monday-brief.md)
>
> **Founders / Execs**: market, engineering pulse and KPIs gathered
> behind one human decision, one dated brief.

> [card] [Release train](https://docs.nika.sh/examples/release-train.md)
>
> **DevOps / Release**: parallel gates, a human GO, a hold until the
> window. Time as a first-class citizen.

## Find the example that teaches X

Looking for one construct? This index is generated from the workflow
files, so it cannot go stale.

| Construct | Taught by |
| - | - |
| [fan-out over a collection](https://docs.nika.sh/concepts/workflows.md) | [bookmark-triage](https://docs.nika.sh/examples/bookmark-triage.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [image-fx-batch](https://docs.nika.sh/examples/image-fx-batch.md) · [localization-factory](https://docs.nika.sh/examples/localization-factory.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) · [resume-screener](https://docs.nika.sh/examples/resume-screener.md) |
| [bounded concurrency](https://docs.nika.sh/concepts/workflows.md) | [bookmark-triage](https://docs.nika.sh/examples/bookmark-triage.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [image-fx-batch](https://docs.nika.sh/examples/image-fx-batch.md) · [localization-factory](https://docs.nika.sh/examples/localization-factory.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) · [resume-screener](https://docs.nika.sh/examples/resume-screener.md) |
| [collect-errors batches](https://docs.nika.sh/concepts/workflows.md) | [bookmark-triage](https://docs.nika.sh/examples/bookmark-triage.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [localization-factory](https://docs.nika.sh/examples/localization-factory.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) · [resume-screener](https://docs.nika.sh/examples/resume-screener.md) |
| [CEL conditional gate](https://docs.nika.sh/concepts/workflows.md) | [ceo-monday-brief](https://docs.nika.sh/examples/ceo-monday-brief.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [config-drift-sentinel](https://docs.nika.sh/examples/config-drift-sentinel.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [etl-quarantine](https://docs.nika.sh/examples/etl-quarantine.md) · [incident-war-room](https://docs.nika.sh/examples/incident-war-room.md) · [invoice-chaser](https://docs.nika.sh/examples/invoice-chaser.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) · [price-watch](https://docs.nika.sh/examples/price-watch.md) · [release-notes](https://docs.nika.sh/examples/release-notes.md) · [release-radar](https://docs.nika.sh/examples/release-radar.md) · [release-train](https://docs.nika.sh/examples/release-train.md) · [resume-screener](https://docs.nika.sh/examples/resume-screener.md) · [support-triage](https://docs.nika.sh/examples/support-triage.md) |
| [transient-error retry](https://docs.nika.sh/reference/error-codes.md) | [bookmark-triage](https://docs.nika.sh/examples/bookmark-triage.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [config-drift-sentinel](https://docs.nika.sh/examples/config-drift-sentinel.md) · [incident-war-room](https://docs.nika.sh/examples/incident-war-room.md) · [release-train](https://docs.nika.sh/examples/release-train.md) |
| [task time-bound](https://docs.nika.sh/concepts/workflows.md) | [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [release-train](https://docs.nika.sh/examples/release-train.md) |
| [fallback recovery](https://docs.nika.sh/reference/error-codes.md) | [bookmark-triage](https://docs.nika.sh/examples/bookmark-triage.md) · [ceo-monday-brief](https://docs.nika.sh/examples/ceo-monday-brief.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [config-drift-sentinel](https://docs.nika.sh/examples/config-drift-sentinel.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [etl-quarantine](https://docs.nika.sh/examples/etl-quarantine.md) · [incident-war-room](https://docs.nika.sh/examples/incident-war-room.md) · [localization-factory](https://docs.nika.sh/examples/localization-factory.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) · [price-watch](https://docs.nika.sh/examples/price-watch.md) · [release-notes](https://docs.nika.sh/examples/release-notes.md) · [release-radar](https://docs.nika.sh/examples/release-radar.md) · [resume-screener](https://docs.nika.sh/examples/resume-screener.md) · [seo-content-brief](https://docs.nika.sh/examples/seo-content-brief.md) · [standup-digest](https://docs.nika.sh/examples/standup-digest.md) |
| [the data boundary · bindings ARE edges](https://docs.nika.sh/concepts/bindings.md) | [bookmark-triage](https://docs.nika.sh/examples/bookmark-triage.md) · [ceo-monday-brief](https://docs.nika.sh/examples/ceo-monday-brief.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [config-drift-sentinel](https://docs.nika.sh/examples/config-drift-sentinel.md) · [contract-guard](https://docs.nika.sh/examples/contract-guard.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [csv-chart-report](https://docs.nika.sh/examples/csv-chart-report.md) · [deep-research-brief](https://docs.nika.sh/examples/deep-research-brief.md) · [etl-quarantine](https://docs.nika.sh/examples/etl-quarantine.md) · [image-fx-batch](https://docs.nika.sh/examples/image-fx-batch.md) · [incident-war-room](https://docs.nika.sh/examples/incident-war-room.md) · [invoice-chaser](https://docs.nika.sh/examples/invoice-chaser.md) · [localization-factory](https://docs.nika.sh/examples/localization-factory.md) · [meeting-actions](https://docs.nika.sh/examples/meeting-actions.md) · [model-bench](https://docs.nika.sh/examples/model-bench.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) · [price-watch](https://docs.nika.sh/examples/price-watch.md) · [release-notes](https://docs.nika.sh/examples/release-notes.md) · [release-radar](https://docs.nika.sh/examples/release-radar.md) · [release-train](https://docs.nika.sh/examples/release-train.md) · [resume-screener](https://docs.nika.sh/examples/resume-screener.md) · [seo-content-brief](https://docs.nika.sh/examples/seo-content-brief.md) · [social-repurpose](https://docs.nika.sh/examples/social-repurpose.md) · [standup-digest](https://docs.nika.sh/examples/standup-digest.md) · [support-triage](https://docs.nika.sh/examples/support-triage.md) · [transcript-shownotes](https://docs.nika.sh/examples/transcript-shownotes.md) |
| [jq extraction bindings](https://docs.nika.sh/concepts/bindings.md) | [ceo-monday-brief](https://docs.nika.sh/examples/ceo-monday-brief.md) · [price-watch](https://docs.nika.sh/examples/price-watch.md) · [release-radar](https://docs.nika.sh/examples/release-radar.md) · [seo-content-brief](https://docs.nika.sh/examples/seo-content-brief.md) |
| [typed (structured) output](https://docs.nika.sh/concepts/verbs.md) | [contract-guard](https://docs.nika.sh/examples/contract-guard.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [deep-research-brief](https://docs.nika.sh/examples/deep-research-brief.md) · [incident-war-room](https://docs.nika.sh/examples/incident-war-room.md) · [meeting-actions](https://docs.nika.sh/examples/meeting-actions.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) · [release-notes](https://docs.nika.sh/examples/release-notes.md) · [resume-screener](https://docs.nika.sh/examples/resume-screener.md) · [seo-content-brief](https://docs.nika.sh/examples/seo-content-brief.md) · [support-triage](https://docs.nika.sh/examples/support-triage.md) · [transcript-shownotes](https://docs.nika.sh/examples/transcript-shownotes.md) |
| [masked secret references](https://docs.nika.sh/reference/yaml-syntax.md) | [ceo-monday-brief](https://docs.nika.sh/examples/ceo-monday-brief.md) · [config-drift-sentinel](https://docs.nika.sh/examples/config-drift-sentinel.md) · [incident-war-room](https://docs.nika.sh/examples/incident-war-room.md) · [price-watch](https://docs.nika.sh/examples/price-watch.md) · [release-notes](https://docs.nika.sh/examples/release-notes.md) · [support-triage](https://docs.nika.sh/examples/support-triage.md) |
| [typed workflow inputs](https://docs.nika.sh/reference/yaml-syntax.md) | [ceo-monday-brief](https://docs.nika.sh/examples/ceo-monday-brief.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [config-drift-sentinel](https://docs.nika.sh/examples/config-drift-sentinel.md) · [contract-guard](https://docs.nika.sh/examples/contract-guard.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [deep-research-brief](https://docs.nika.sh/examples/deep-research-brief.md) · [incident-war-room](https://docs.nika.sh/examples/incident-war-room.md) · [meeting-actions](https://docs.nika.sh/examples/meeting-actions.md) · [release-notes](https://docs.nika.sh/examples/release-notes.md) · [release-train](https://docs.nika.sh/examples/release-train.md) · [seo-content-brief](https://docs.nika.sh/examples/seo-content-brief.md) |
| [typed workflow outputs (callable)](https://docs.nika.sh/reference/yaml-syntax.md) | [bookmark-triage](https://docs.nika.sh/examples/bookmark-triage.md) · [ceo-monday-brief](https://docs.nika.sh/examples/ceo-monday-brief.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [config-drift-sentinel](https://docs.nika.sh/examples/config-drift-sentinel.md) · [contract-guard](https://docs.nika.sh/examples/contract-guard.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [csv-chart-report](https://docs.nika.sh/examples/csv-chart-report.md) · [deep-research-brief](https://docs.nika.sh/examples/deep-research-brief.md) · [etl-quarantine](https://docs.nika.sh/examples/etl-quarantine.md) · [image-compose-sheet](https://docs.nika.sh/examples/image-compose-sheet.md) · [image-fx-batch](https://docs.nika.sh/examples/image-fx-batch.md) · [incident-war-room](https://docs.nika.sh/examples/incident-war-room.md) · [invoice-chaser](https://docs.nika.sh/examples/invoice-chaser.md) · [localization-factory](https://docs.nika.sh/examples/localization-factory.md) · [meeting-actions](https://docs.nika.sh/examples/meeting-actions.md) · [model-bench](https://docs.nika.sh/examples/model-bench.md) · [og-images](https://docs.nika.sh/examples/og-images.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) · [price-watch](https://docs.nika.sh/examples/price-watch.md) · [release-notes](https://docs.nika.sh/examples/release-notes.md) · [release-radar](https://docs.nika.sh/examples/release-radar.md) · [release-train](https://docs.nika.sh/examples/release-train.md) · [remove-owned-file](https://docs.nika.sh/examples/remove-owned-file.md) · [resume-screener](https://docs.nika.sh/examples/resume-screener.md) · [seo-content-brief](https://docs.nika.sh/examples/seo-content-brief.md) · [social-repurpose](https://docs.nika.sh/examples/social-repurpose.md) · [standup-digest](https://docs.nika.sh/examples/standup-digest.md) · [support-triage](https://docs.nika.sh/examples/support-triage.md) · [transcript-shownotes](https://docs.nika.sh/examples/transcript-shownotes.md) |
| [default-deny tool grants](https://docs.nika.sh/concepts/verbs.md) | [deep-research-brief](https://docs.nika.sh/examples/deep-research-brief.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) |
| [local inference](https://docs.nika.sh/concepts/providers.md) | [ceo-monday-brief](https://docs.nika.sh/examples/ceo-monday-brief.md) · [competitor-radar](https://docs.nika.sh/examples/competitor-radar.md) · [config-drift-sentinel](https://docs.nika.sh/examples/config-drift-sentinel.md) · [contract-guard](https://docs.nika.sh/examples/contract-guard.md) · [corpus-digest](https://docs.nika.sh/examples/corpus-digest.md) · [deep-research-brief](https://docs.nika.sh/examples/deep-research-brief.md) · [incident-war-room](https://docs.nika.sh/examples/incident-war-room.md) · [invoice-chaser](https://docs.nika.sh/examples/invoice-chaser.md) · [localization-factory](https://docs.nika.sh/examples/localization-factory.md) · [meeting-actions](https://docs.nika.sh/examples/meeting-actions.md) · [pr-review-fanout](https://docs.nika.sh/examples/pr-review-fanout.md) · [release-notes](https://docs.nika.sh/examples/release-notes.md) · [release-radar](https://docs.nika.sh/examples/release-radar.md) · [resume-screener](https://docs.nika.sh/examples/resume-screener.md) · [seo-content-brief](https://docs.nika.sh/examples/seo-content-brief.md) · [social-repurpose](https://docs.nika.sh/examples/social-repurpose.md) · [standup-digest](https://docs.nika.sh/examples/standup-digest.md) · [support-triage](https://docs.nika.sh/examples/support-triage.md) · [transcript-shownotes](https://docs.nika.sh/examples/transcript-shownotes.md) |

## The rules every example obeys

* **One verb per task** · `infer`, `exec`, `invoke` or `agent`.
* **The binding IS the edge** · `${{ tasks.X.* }}` lives in `with:`
  (data) — each reference declares a typed edge — and `after:` orders on
  state. The DAG has no invisible edges, and the body reads
  `${{ with.<name> }}`, never `tasks.*` (`NIKA-VAR-021`).
* **Local by default** · a showcase that calls a model names a local
  Ollama model (`ollama/qwen3.5:4b` for most): zero API keys, inference
  stays on your machine. Cloud providers appear only as swap hints, never
  as the default.
* **Projection, not copy-paste** · these pages and the
  [nika.sh use cases](https://nika.sh/use-cases) render the same spec
  files, projected by the spec's `showcase-projector.py`; nobody edits
  the copies by hand.

Repeat an AI task every week? Describe it in the
[terminal Session](https://docs.nika.sh/getting-started/session.md) and keep the `.nika` file it
writes.

> [card] [Write your first workflow](https://docs.nika.sh/getting-started/first-workflow.md)
>
> Ready to write your own? Start from the guided first-workflow walk.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.