From 4684160d4e0329f6595e0ee31b4d9a3723622918 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Thibaut=20M=C3=89LEN?=
 <20891897+ThibautMelen@users.noreply.github.com>
Date: Sat, 11 Jul 2026 14:42:05 +0200
Subject: [PATCH] sheets: add nika
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Nika 🦋 <nika@supernovae.studio>
---
 sheets/nika | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 sheets/nika

diff --git a/sheets/nika b/sheets/nika
new file mode 100644
index 0000000..3b5753d
--- /dev/null
+++ b/sheets/nika
@@ -0,0 +1,55 @@
+# nika
+# Workflow engine for AI: .nika.yaml DAGs statically checked before
+# execution (schema, permits, cost), tamper-evident traces after.
+
+# List the embedded example workflows:
+nika examples list
+
+# Run an example offline (no API key, no model server):
+nika examples run 01-hello --model mock/echo
+
+# Run the same example against a local Ollama model:
+nika examples run 01-hello --model ollama/llama3.2:3b
+
+# Scaffold a new workflow from a template:
+nika new --from daily-brief my-workflow.nika.yaml
+
+# Statically check a workflow (exit 0 = clean, 2 = findings):
+nika check my-workflow.nika.yaml
+
+# Generate the tightest permits: block (default-deny once present):
+nika check --infer-permits my-workflow.nika.yaml
+
+# Explain a diagnostic code:
+nika explain NIKA-SEC-004
+
+# Run a workflow with a variable and a hard cost cap:
+nika run my-workflow.nika.yaml --var topic=rust --max-cost-usd 2
+
+# Narrate what a workflow does (waves, cost, touches) before running it:
+nika explain my-workflow.nika.yaml
+
+# Show the anatomy of a workflow (tasks, waves, cost floor):
+nika inspect my-workflow.nika.yaml
+
+# List providers and models this machine can run:
+nika catalog
+
+# List the built-in nika:* tools an invoke task can reach:
+nika tools
+
+# Check provider keys, PATH and local model servers:
+nika doctor
+
+# Verify the hash chain of the latest run's trace:
+nika trace verify
+
+# Read the latest trace as a human card:
+nika trace show
+
+# Pin a workflow's offline behavior as a golden test, then replay it:
+nika test my-workflow.nika.yaml --update
+nika test my-workflow.nika.yaml
+
+# Serve the read-only MCP oracle over stdio (for agent clients):
+nika mcp