0.7.0 - 2026-09-08
Release Notes
Mega-plan execution (30 commits): plan-mode approval gates, oracle
integrity, honest cost metering, independence hardening, session control
plane, headless CI contract, trust posture, automation, and TUI unification.
All user-facing claims below are covered by tests, mock-LLM end-to-end runs,
or the VHS visual gate (tests/visual/, 12 reference frames at 0.00%
self-diff).
Added
- Plan mode:
niki planresearches without executing and writes reviewableplan.md;niki run --plan <id>executes the approved spec, skipping the Planner LLM call. Dry runs no longer create empty branch refs. - Session CLI:
niki session list/show/checkpoints/undo/rewindwith code+conversation/both restore modes and a dirty-tree guard. - User slash commands:
.niki/commands/*.md(filename →/name) withdescription:/aliases:frontmatter,[commands] extra_dirssharing, andniki commands list/show/expand. - Headless contract:
niki run --bare(no memory/MCP/knowledge-URLs),--output-format jsonstable envelope (incl. error path), stdout pipe-purity (display mute + captured git stdio), OTLP trace export (--otel-endpoint, no new dependencies). - Oracle integrity:
oracle_source(spec/derived/property) on every test case, reviewer oracle-check rule, no-healing rule, opt-in[agents.tester] mutation_commandgate; red-suite/mutation failures block the branch unless--force(recorded as NOT verified). - Independence hardening: Red receives evidence-only diffs, isolation records match wiring, topology selection reason recorded and reported, shared-model review warnings.
- Honest meter: cached-input/reasoning token splits, unpriced-model warnings
(
unpriced*in reports), price-table freshness test, failover cache-bust warnings, history-drivenniki recommend --project. - Trust posture:
[permissions] mode+--permission-mode,disable_worktreekill-switch,fail_closed_headlessflag, loud headless Ask fallback. - Lifecycle hooks:
[hooks.commands]wired to PreTaskStart/PreAgentStart/ PostAgentStop/PostTaskStop, fail-closed block semantics. - GitHub automation: keyless nightly eval gate, human-gated
@nikireview workflow (injection-safe, loop-guarded). - Eval credibility: per-case costs, disclosure manifest on every run,
niki eval grademaintainer judgments with agreement metric, ablation protocol doc. - Observability:
trace.jsonlspans per run (honestly derived timeline),niki auditcompliance bundles. - MCP Streamable-HTTP remote transport (JSON + SSE, session affinity).
- Onboarding:
niki initalias,init --scanAGENTS.md drafter,.niki/rules/binding conventions, per-provider model aliases, per-agenteffortpresets, actionable key errors, guided empty states. - TUI unification: one status grammar, 100% theme-token production code, normalized headers, global page jumps in both event loops, palette fleet/session rows, empty-state triads.
- TUI motion system: primitives + caret blink, Done slide-in, notice slide-in, progress shimmer, modal pulse, verdict pulse — all reduced-motion gated (frames pixel-identical with the flag on).
Fixed
GEMINI_API_KEYvsGOOGLE_API_KEYchat fallback miss.smoke/doctorpointed at nonexistentniki init(now a real alias).- Unwired
schemas/review_feedback.schema.jsonremoved. backend = "podman"doc strings corrected (docker|worktree only).safety_proof.jsonscope documented as git-only (was overclaimed).- Approval tool auto-approved everything; ask tool invented answers.
[permissions]table silently dropped by config merge.- MCP
JsonRpcResponsenever parsed (jsonrpcfield rename bug). - Dry-run empty branch refs; planner-skip metrics crash.
- Global key
h/s/ldead-ends; blank session screen;$-0.00.
Changed
safety_proof.json, spend-cap, and deny-list copy narrowed to match code.niki recommendstatic-pairings truth in docs (history-driven per-project observed spend added to the command itself).
Install niki 0.7.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/RavaniRoshan/niki/releases/download/v0.7.0/niki-installer.sh | sh
Install prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/RavaniRoshan/niki/releases/download/v0.7.0/niki-installer.ps1 | iex"
Download niki 0.7.0
| File | Platform | Checksum |
|---|---|---|
| niki-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| niki-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| niki-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| niki-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| niki-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |