/hermes-agent

name: zorro-agent
description: Complete guide to using and extending Zorro Agent — CLI usage, setup, configuration, spawning additional agents, gateway platforms, skills, voice, tools, profiles, and a concise contributor reference. Load this skill when helping users configure Zorro, troubleshoot issues, spawn agent instances, or make code contributions.
version: 2.0.0
author: Zorro Agent + Teknium
license: MIT
metadata:
  zorro:
    tags: [zorro, setup, configuration, multi-agent, spawning, cli, gateway, development]
    homepage: https://github.com/NousResearch/zorro-agent
    related_skills: [claude-code, codex, opencode]

Zorro Agent

Zorro Agent is an open-source AI agent framework by Brax that runs in your terminal, messaging platforms, and IDEs. It belongs to the same category as Claude Code (Anthropic), Codex (OpenAI), and OpenClaw — autonomous coding and task-execution agents that use tool calling to interact with your system. Zorro works with any LLM provider (OpenRouter, Anthropic, OpenAI, DeepSeek, local models, and 15+ others) and runs on Linux, macOS, and WSL.

What makes Zorro different:

• **Self-improving through skills** — Zorro learns from experience by saving reusable procedures as skills. When it solves a complex problem, discovers a workflow, or gets corrected, it can persist that knowledge as a skill document that loads into future sessions. Skills accumulate over time, making the agent better at your specific tasks and environment.
• **Persistent memory across sessions** — remembers who you are, your preferences, environment details, and lessons learned. Pluggable memory backends (built-in, Honcho, Mem0, and more) let you choose how memory works.
• **Multi-platform gateway** — the same agent runs on Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, and 10+ other platforms with full tool access, not just chat.
• **Provider-agnostic** — swap models and providers mid-workflow without changing anything else. Credential pools rotate across multiple API keys automatically.
• **Profiles** — run multiple independent Zorro instances with isolated configs, sessions, skills, and memory.
• **Extensible** — plugins, MCP servers, custom tools, webhook triggers, cron scheduling, and the full Python ecosystem.

People use Zorro for software development, research, system administration, data analysis, content creation, home automation, and anything else that benefits from an AI agent with persistent context and full system access.

**This skill helps you work with Zorro Agent effectively** — setting it up, configuring features, spawning additional agent instances, troubleshooting issues, finding the right commands and settings, and understanding how the system works when you need to extend or contribute to it.

**Docs:** https://zorro-agent.nousresearch.com/docs/

Quick Start

# Install
curl -fsSL https://raw.githubusercontent.com/NousResearch/zorro-agent/main/scripts/install.sh | bash

# Interactive chat (default)
zorro

# Single query
zorro chat -q "What is the capital of France?"

# Setup wizard
zorro setup

# Change model/provider
zorro model

# Check health
zorro doctor

---

CLI Reference

Global Flags

zorro [flags] [command]

  --version, -V             Show version
  --resume, -r SESSION      Resume session by ID or title
  --continue, -c [NAME]     Resume by name, or most recent session
  --worktree, -w            Isolated git worktree mode (parallel agents)
  --skills, -s SKILL        Preload skills (comma-separate or repeat)
  --profile, -p NAME        Use a named profile
  --yolo                    Skip dangerous command approval
  --pass-session-id         Include session ID in system prompt

No subcommand defaults to `chat`.

Chat

zorro chat [flags]
  -q, --query TEXT          Single query, non-interactive
  -m, --model MODEL         Model (e.g. anthropic/claude-sonnet-4)
  -t, --toolsets LIST       Comma-separated toolsets
  --provider PROVIDER       Force provider (openrouter, anthropic, nous, etc.)
  -v, --verbose             Verbose output
  -Q, --quiet               Suppress banner, spinner, tool previews
  --checkpoints             Enable filesystem checkpoints (/rollback)
  --source TAG              Session source tag (default: cli)

Configuration

zorro setup [section]      Interactive wizard (model|terminal|gateway|tools|agent)
zorro model                Interactive model/provider picker
zorro config               View current config
zorro config edit          Open config.yaml in $EDITOR
zorro config set KEY VAL   Set a config value
zorro config path          Print config.yaml path
zorro config env-path      Print .env path
zorro config check         Check for missing/outdated config
zorro config migrate       Update config with new options
zorro login [--provider P] OAuth login (nous, openai-codex)
zorro logout               Clear stored auth
zorro doctor [--fix]       Check dependencies and config
zorro status [--all]       Show component status

Tools & Skills

zorro tools                Interactive tool enable/disable (curses UI)
zorro tools list           Show all tools and status
zorro tools enable NAME    Enable a toolset
zorro tools disable NAME   Disable a toolset

zorro skills list          List installed skills
zorro skills search QUERY  Search the skills hub
zorro skills install ID    Install a skill
zorro skills inspect ID    Preview without installing
zorro skills config        Enable/disable skills per platform
zorro skills check         Check for updates
zorro skills update        Update outdated skills
zorro skills uninstall N   Remove a hub skill
zorro skills publish PATH  Publish to registry
zorro skills browse        Browse all available skills
zorro skills tap add REPO  Add a GitHub repo as skill source

MCP Servers

zorro mcp serve            Run Zorro as an MCP server
zorro mcp add NAME         Add an MCP server (--url or --command)
zorro mcp