Nogra.

Install · Claude Code · v0.6.6

Install Nogra.

The current public install runs inside Claude Code. The commands below match the public 0.6.6 package in the Nogra marketplace source.

Public marketplace source: github.com/nograai/nogra-claude-marketplace · Apache-2.0.

  1. 01

    Prerequisites

    Claude Code installed and Node.js 18+ on your PATH. Nogra's local runtime is a small Node script bundled with the plugin.

  2. 02

    Add the marketplace

    claude plugin marketplace add nograai/nogra-claude-marketplace

    Registers Nogra's public marketplace source with your Claude Code installation.

  3. 03

    Install the plugin

    claude plugin install nogra@nogra-claude

    Installs the public Nogra plugin into Claude Code.

  4. 04

    Verify it's installed

    /nogra:status

    Shows the plugin version, workspace id, recent local records, and checkpoint freshness. If you see a plugin ref, you're good.

  5. 05

    Initialize your workspace

    /nogra:setup

    Sets up .nogra/ in your project root. This is the local trust store — briefs, dispatch receipts, evidence, checkpoints, decisions, and current tasks. Plain markdown and JSON. You can read it. You can git commit it.

First brief

Your first brief

Type /nogra:brief followed by what you want to do. Nogra drafts a brief from your intent, you review the scope and evidence contract, then you say GO when you're ready.

If the work spans lanes, modes, or multiple runs, shape the orchestration first: topology, role fit, evidence join, and stop boundary. Then write the brief.

Dispatch spawns a fresh executor against the brief. Verify checks the returned output against the contract. Both steps leave a receipt in .nogra/ that you can git log.

Install the plugin, set up the workspace, then use Nogra when you want approved work checked against a plan.

Troubleshooting

If something is off

  • /nogra:status— inspect installed version, workspace state, and freshness.
  • /nogra:update— refresh Nogra guidance without starting work.
  • /nogra:watch— inspect recent local hook events when you need visibility.
  • github issues— file a bug or ask a question.