install · v0.116.2

Um binário. Sua máquina.

Instale. Um comando. Roda.

Você já tem Claude Code ou Codex. Sem chave de API, sem modelo para baixar. Nika é um único binário Rust: sem daemon, sem conta. Instale, depois nika new hello.

macOS · Linux · air-gapped OK

1. 01 · homebrew

   O one-liner

   macOS ou Linux com Homebrew: no seu PATH na hora. Confira com nika --version.

   ❯brew install supernovae-st/tap/…/nikaCopy

   o que você deve ver

   ❯ nika --versionnika 0.116.2 (c4cdbeafb)

   real output · nika 0.116.2 · nika --version · re-captured at every release

2. 02 · script

   Sem Homebrew

   Baixa o binário de release verificado em ~/.nika/bin e imprime a única linha PATH para adicionar ao seu perfil de shell. Reabra o terminal e nika --version responde.

   ❯curl -LsSf https://nika.sh/install.sh | shCopy

   Já carrega uma toolchain? O cargo busca o tarball de release pré-compilado, sem compilar (o binário chega como nika-cli até a publicação no crates.io: um symlink para o nome público, uma vez). O nix constrói a source exata da release via o flake do repo; o primeiro run compila, o store guarda em cache.

   ❯cargo binstall --git https://github.com/supernovae-st/nika nika-cliCopy

   ❯nix run github:supernovae-st/nikaCopy

3. 03 · manual

   Air-gapped, ou na mão

   Baixe o tarball da sua plataforma e o SHA256SUMS da última release, verifique, e mova o nika para o seu PATH. Nada liga para casa.

   ❯sha256sum -c SHA256SUMS --ignore-missingCopy

4. 04 · editor

   A extensão do editor

   supernovae.nika-lang · no VS Code Marketplace e no Open VSX (Cursor · Windsurf · VSCodium). Ela baixa automaticamente o binário nika da release correspondente no primeiro uso, ou reutiliza o que já está no seu PATH. Qualquer outro editor: nika lsp fala LSP por stdio · source + issues.

   completions · diagnósticos · uma visão do plano · no seu editor

5. 05 · agentes

   Trabalhe com os seus agentes

   Nika foi feito para ser escrito por agentes e revisado por você. nika init coloca o wiring do schema + AGENTS.md no seu repo para que Claude Code, Cursor, Codex e companhia escrevam workflows válidos de primeira; nika wire adiciona wiring agent-tool (MCP) explícito onde você quiser.

   ❯nika initCopy

   ❯nika wire cursorCopy

6. 06 · primeiro run

   Zero chaves, zero download

   Comece com nika welcome, o espelho: o que esta máquina já tem (editores · presença de chaves, nunca valores) e a linha Next. Na release atual essa linha é nika new hello. Offline, zero chaves, nada escrito, em um segundo. Um ensaio, não uma resposta cobrada. Para guardar um arquivo: nika new snippets/hello, depois nika check e nika run. Um modelo local ou uma chave cloud vem depois, não primeiro. nika doctor nomeia o que já está ligado.

   ❯nika welcomeCopy

   ❯nika new helloCopy

   ❯nika check hello.nika.yamlCopy

   ❯nika run hello.nika.yamlCopy

   ❯nika doctorCopy
   o que você deve ver

   ❯ nika new hellowrote hello.nika.yaml · nika run hello.nika.yaml❯ nika run hello.nika.yaml  🦋 nika · hello · 1 task     permits ✓ declared boundary · default-deny  ✔  greet  infer · mock/echo  0ms  ── 1/1 done · ≥ $0.00 (1 unpriced) · elapsed 0.0s ──────────────    wrote .nika/traces    said "mock(echo) · Say hello in French, in one sh…"    see it whole: nika trace outputs    rehearsal · a mock model echoed the prompt — not a real answer    trace: .nika/traces/<this run> · 5 events · chain <hash-chained>

   real output · nika 0.116.2 · nika new hello · re-captured at every release

   hello.nika.yamlsource ↗Copy

   1# first file after install · one exec, zero setup, zero keys2nika: hello3⛨permits:4  ⛨exec: ["echo"]5tasks:6  greet:7    ▷exec:8      command: ["echo", "hello", "from", "nika"]

   read it in the spec →

   o que você deve ver

   ❯ nika check hello.nika.yamlnika check · hello.nika.yaml ✔ PLAN     1 wave · 1 task · max parallelism 1      wave 1 greet (exec · echo) ✔ COST     no infer/agent tasks · $0.00 · exec + mcp spend unpriced ✔ SECRETS  no declared secret reaches an effect · model echo untracked ✔ TYPES    deep references fit the shapes tasks declare · builtin output has none ✔ TOOLS    every named nika: tool is canonical · globs + mcp: not checked ✔ ARGS     every builtin invoke arg key is declared + required args present ✔ SCHEMA   no known-unsatisfiable form in an authored schema: · $ref opaque ✔ GATES    no task proven dead · status literals in vocabulary ✔ WRITES   no two unordered tasks write the same static path · computed paths at run · engine writes .nika/traces ✔ EXEC     no literal argv the exec floor refuses at run · a templated argv is the RUN's verdict ✔ ORDER    no exec: sits downstream of a net-effecting task · unauthored content never reaches a shell ✔ PERMITS  literal + const: args fit the boundary · computed paths + symlinks are the RUN's verdict · exec outside the fs bounds ✔ TRIFECTA no lethal trifecta over the declared permits: without a human gate ✔ JOURNEY internal · 0 sources · 1 destination · 0 model endpoints · no secret reaches an external destination ✔ audited · 1 task · 1 wave · permits exec:echo · est out ≤$0.0000 · 0 hints · risk supervised❯ nika run hello.nika.yaml  🦋 nika · hello · 1 task     permits ✓ declared boundary · exec outside the fs bounds  ✔  greet  exec · echo  8ms  ── 1/1 done · $0.00 · elapsed 0.0s ─────────────────────────────    wrote .nika/traces    trace: .nika/traces/2026-09-01T00-31-01Z-cd68.ndjson · 8 events · chain 93c13fc0b1070dce8597db1950c93b0522336270451ef3b1bd51a5da9a4d12e0 · sealed

   real output · nika 0.116.2 · nika check hello.nika.yaml · re-captured at every release

   hello-ai.nika.yamlsource ↗Copy

   1# first infer · mock rehearsal · zero keys · zero download2nika: hello-ai3model: mock/echo4⛨permits: {}5tasks:6  greet:7    ◇infer:8      prompt: "Say hello in one sentence."9      max_tokens: 6410​11outputs:12  greeting: ${{ tasks.greet.output }}

   read it in the spec →

Próximo: aprenda o arquivo em 5 minutos · veja workflows reais · docs completas