Netro CLI — Documentation

## Install

One line. The installer downloads a standalone binary and puts netro on your PATH — no npm or Node needed.

macOS / Linux

curl -fsSL https://www.netrocli.bond/install.sh | bash

Windows (PowerShell)

irm https://www.netrocli.bond/install.ps1 | iex

Verify:

netro --version

## Quick start

cd your-project
netro                     # start the interactive agent

> explain what this repo does
> add a health-check endpoint and a test for it
> /help                   # list all commands

Netro reads your project files, runs tools (read/write/edit/bash/grep), and keeps a live HUD at the bottom showing model, context usage, cost, running tools, and todos.

## Subscription & login

The CLI is free with your own API keys. A subscription gives you hosted model access (no keys of your own) via an access key.

• Subscribe on Telegram: t.me/netro_1933
• You receive an access key like netro-xxxxxxxx…

## Commands

Type /help in-session for the full list. Highlights:

Core

Workflow & session

Extend & ops

## Effort / reasoning

Netro exposes seven effort levels: off · minimal · low · medium · high · xhigh · max. Set them live:

/effort high
/effort max
/effort cycle       # step to the next level

Effort is sent to the provider as a real reasoning hint. When the HUD badge shows high/xhigh/max, a pulsing marker glows to signal deep reasoning is engaged.

## Coordinator

For non-trivial tasks, netro can act as a coordinator that directs specialist subagents through phases: Research → Synthesis → Implementation → Verification.

/coordinator on     # enable orchestration discipline
/coordinator status

• Read-only research runs in parallel.
• Write-heavy work is serialized per file-set — subagents never clobber each other.
• Verification runs with fresh eyes to prove changes work, not just that they exist.

Powered by the subagent tool (single / parallel / chain modes) and 50+ specialist agents.

## Web search & fetch

Two tools bring the live web into a session:

Keyless search works out of the box (via Bing RSS). For higher-volume, dependable results, set an API key:

# any one of these enables premium search
export BRAVE_API_KEY=...      # brave.com/search/api (free tier)
export SERPER_API_KEY=...     # serper.dev
export TAVILY_API_KEY=...     # tavily.com

## Guardian / pentest

Netro can orchestrate Guardian-style security assessments without shipping 50 scanner binaries in the install zip. Same external CLIs Guardian wraps (nmap, httpx, nuclei, subfinder, …) — installed on demand.

Windows

/guardian install
# or:
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.netro\agent\scripts\install-guardian-tools-windows.ps1" -CoreOnly

Linux / macOS

/guardian install
# or:
bash ~/.netro/agent/scripts/install-guardian-tools.sh

Skill: guardian-pentest (phases Planner → Tool → Analyst → Reporter, findings JSONL).

## Updates

Netro checks https://www.netrocli.bond/releases/latest.json for new versions.

## Privacy / stealth

Every outbound request (web fetch, search, downloads) is rewritten to look like an ordinary Chrome browser, so target sites see normal traffic instead of an automated client. Telemetry is off by default.

/stealth                          # show status

# route ALL traffic through a proxy / Tor so the
# destination logs the proxy's IP, not yours:
export NETRO_PROXY=socks5://127.0.0.1:9050

## Configuration

Everything lives in ~/.netro/agent/ — plain files, no magic.

~/.netro/agent/
├── settings.json     # HUD, theme, defaults
├── models.json       # providers & custom models
├── auth.json         # provider credentials (hashed)
├── skills/           # installed skills
├── prompts/          # prompt templates
├── agents/           # subagent definitions
└── sessions/         # saved sessions

settings.json

{
  "hud": {
    "display": { "showTools": true, "showTodos": true, "showCost": true },
    "colors": { "model": "cyan", "context": "green" }
  }
}

## Providers & models

Netro speaks one unified LLM API across Anthropic, OpenAI, Google, xAI, Bedrock, OpenRouter, and any OpenAI-compatible endpoint. Add a custom model in ~/.netro/agent/models.json:

{
  "providers": {
    "my-provider": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "sk-...",
      "models": [{ "id": "my-model", "contextWindow": 200000, "reasoning": true }],
      "compat": { "thinkingFormat": "openrouter", "supportsReasoningEffort": true }
    }
  }
}

Switch mid-session with /provider or /model — context is preserved.

## Skills

Skills are reusable procedures the agent can invoke. 110+ ship built-in (dev stacks, DevOps, deployment). Install more from any repo:

/skill-install github.com/acme/deploy-skills

Each skill is a SKILL.md with YAML frontmatter (name, description) plus a body of numbered steps. Skills can register their own slash commands and hot-reload per session.

## Agents

Specialist subagents run tasks in isolated context. 50+ ship built-in (verifier, silent-failure-hunter, architects, and more). Create your own:

/agent-new a reviewer that checks for security issues

Delegate to them through the subagent tool (single / parallel / chain), or let the coordinator orchestrate them for you.

## MCP

Connect Model Context Protocol servers via ~/.netro/agent/mcp.json (or project .mcp.json). Tools appear as mcp__<server>__<tool>.

{
  "mcpServers": {
    "fs": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

## Cooperation / free

Netro is a local operator harness. Default posture is cooperative technical work (security testing, automation, dual-use code on systems you name as scope) without policy lectures.

## Troubleshooting

Install command "308 Permanent Redirect"

Vercel redirects netrocli.bond → www.netrocli.bond (308). PowerShell irm and some curl builds don't follow 308 redirects. Use the www host exactly: https://www.netrocli.bond/install.ps1.

Windows: curl -fsSL fails in PowerShell

Use the PowerShell installer instead: irm https://www.netrocli.bond/install.ps1 | iex

Home page shows both Windows and Linux install lines

Hard-refresh (Ctrl+Shift+R). The site auto-picks your OS and shows one command; tabs switch OS without stacking both panes.

dist/dist/.../dark.json ENOENT on start

Fixed in current releases. Run /update now or reinstall from the site.

Logged out after opening netro

Your key hash was revoked or set active: false on the registry. Contact the operator for a new key, then /cli-login.

/guardian tools shows mostly missing

Scanners are optional. Run /guardian install, then open a new terminal so ~/.netro/agent/bin is on PATH.

Skill conflicts on startup

Every SKILL.md needs a description in its frontmatter. Built-in skills already have this; if you added your own, check the frontmatter.

Effort clamps to "off"

Your model doesn't advertise reasoning. Set NETRO_FORCE_EFFORT=1 (default) and add "reasoning": true to the model in models.json.