For CLI

Run in any terminal.

• $In your terminal: npm i -g github:noro-to/noro Copy

Or run it once without installing: npx @noro-to/noro this report.csv

For Claude plugin

In the Claude Code chat, add the marketplace, then install the plugin.

• ›In your agent chat: /plugin marketplace add noro-to/noro Copy
• ›In your agent chat: /plugin install noro@noro Copy

Update it later from the /plugin menu.

For Codex

Add the marketplace in your terminal.

• $In your terminal: codex plugin marketplace add noro-to/noro Copy

Then open Plugins in Codex, find noro and install it.

For Hermes

Install the CLI and set your key, then add the skill to Hermes.

• $In your terminal: npm i -g github:noro-to/noro && noro init Copy
• $In your terminal: hermes skills install skills-sh/noro-to/noro/noro Copy

Or use skills.sh: npx skills add noro-to/noro -g -a hermes-agent

mcp_servers:
  noro:
    command: "npx"
    args: ["-y", "@noro-to/noro", "mcp"]
    timeout: 600
    connect_timeout: 30

For skills.sh

Run in your terminal. It installs the skill for every agent it finds: Claude Code, Codex, Cursor, Copilot, Zed and more.

• $In your terminal: npx skills add noro-to/noro Copy

Update it later with npx skills update noro

For MCP

Pick your host.

[mcp_servers.noro]
command = "npx"
args = ["-y", "@noro-to/noro", "mcp"]
startup_timeout_sec = 30
tool_timeout_sec = 600

{
  "mcpServers": {
    "noro": { "command": "npx", "args": ["-y", "@noro-to/noro", "mcp"] }
  }
}

mcp_servers:
  noro:
    command: "npx"
    args: ["-y", "@noro-to/noro", "mcp"]
    timeout: 600
    connect_timeout: 30

{
  "mcpServers": {
    "noro": { "command": "npx", "args": ["-y", "@noro-to/noro", "mcp"] }
  }
}

"context_servers": {
  "noro": { "command": "npx", "args": ["-y", "@noro-to/noro", "mcp"] }
}

noro adds two tools: noro_this writes or audits a report, and noro_facts returns the computed facts table with no model call.

For CLI, Hermes

Answer a few questions and noro writes the file for you:

• $In your terminal: noro init Copy

Or add the lines below to ~/.config/noro/.env yourself.

For Claude plugin, Codex, skills.sh, MCP

Answer a few questions and noro writes the file for you:

• $In your terminal: npx -y @noro-to/noro init Copy

Or add the lines below to ~/.config/noro/.env yourself.

For CLI

Check the setup for free, then point noro at an export.

• $In your terminal: noro doctor Copy
• $In your terminal: noro this ~/Downloads/campaign-report.csv Copy

Point it at a report you wrote and noro audits and rewrites it. Either way it asks about each flag: keep, cut or reword.

For Claude plugin, Codex, skills.sh

Check the setup for free, then start a new chat in any folder and ask:

• $In your terminal: npx -y @noro-to/noro doctor Copy
• ›In your agent chat: noro this ~/Downloads/campaign-report.csv Copy

The skill runs noro, shows you the report and asks about each flag: keep, cut or reword.

For Hermes

Check the setup for free, then ask Hermes in any chat, including Slack or Telegram:

• $In your terminal: noro doctor Copy
• ›In your agent chat: noro this ~/Downloads/campaign-report.csv Copy

Hermes runs noro, shows you the report and asks about each flag: keep, cut or reword.

For MCP

Check the setup for free, then ask your agent:

• $In your terminal: npx -y @noro-to/noro doctor Copy
• ›In your agent chat: Use noro on ~/Downloads/campaign-report.csv Copy

Your agent calls noro_this and gets the report back with every number traced to a fact id.

For Hermes

With Hermes cron

A weekly report, delivered where Hermes talks to you:

• $In your terminal: hermes cron create "every monday 9am" "noro this ~/exports/latest.csv --format slack" --skill noro --name noro-weekly Copy

Set delivery to slack or telegram when Hermes asks.

In GitHub Actions

Copy the weekly workflow into your repo and add OPENROUTER_API_KEY as a repository secret. It runs every Monday.

Get the workflow template →

With cron

Add this line with crontab -e. It runs Mondays at 07:17.

•  Line to paste: 17 7 * * 1 cd ~/reports && /usr/local/bin/noro this exports/latest.csv --yes > report.md Copy

In Docker

No Node or Python on the machine. Run it from the folder that holds your .env.

• $In your terminal: docker run --rm -it -v "$PWD:/work" -w /work --env-file .env ghcr.io/noro-to/noro this exports/latest.csv Copy

Subscription writers need your own login, so use an API key in Docker and CI.