diff --git a/website/docs/reference/cli-commands.md b/website/docs/reference/cli-commands.md index 0734cd140..d527b61e2 100644 --- a/website/docs/reference/cli-commands.md +++ b/website/docs/reference/cli-commands.md @@ -344,6 +344,41 @@ pip install -e '.[acp]' See [ACP Editor Integration](../user-guide/features/acp.md) and [ACP Internals](../developer-guide/acp-internals.md). +## `hermes mcp` + +```bash +hermes mcp +``` + +Manage MCP (Model Context Protocol) server configurations. + +| Subcommand | Description | +|------------|-------------| +| `add [--url URL] [--command CMD] [--args ...] [--auth oauth\|header]` | Add an MCP server with automatic tool discovery. | +| `remove ` (alias: `rm`) | Remove an MCP server from config. | +| `list` (alias: `ls`) | List configured MCP servers. | +| `test ` | Test connection to an MCP server. | +| `configure ` (alias: `config`) | Toggle tool selection for a server. | + +See [MCP Config Reference](./mcp-config-reference.md) and [Use MCP with Hermes](../guides/use-mcp-with-hermes.md). + +## `hermes plugins` + +```bash +hermes plugins +``` + +Manage Hermes Agent plugins. + +| Subcommand | Description | +|------------|-------------| +| `install [--force]` | Install a plugin from a Git URL or `owner/repo`. | +| `update ` | Pull latest changes for an installed plugin. | +| `remove ` (aliases: `rm`, `uninstall`) | Remove an installed plugin. | +| `list` (alias: `ls`) | List installed plugins. | + +See [Plugins](../user-guide/features/plugins.md) and [Build a Hermes Plugin](../guides/build-a-hermes-plugin.md). + ## `hermes tools` ```bash diff --git a/website/docs/reference/optional-skills-catalog.md b/website/docs/reference/optional-skills-catalog.md index 212c49c0f..9b7c1c683 100644 --- a/website/docs/reference/optional-skills-catalog.md +++ b/website/docs/reference/optional-skills-catalog.md @@ -18,8 +18,16 @@ Official optional skills live in the repository under `optional-skills/`. Instal | Skill | Description | Path | |-------|-------------|------| +| `base` | Query Base (Ethereum L2) blockchain data with USD pricing — wallet balances, token info, transaction details, gas analysis, contract inspection. | `blockchain/base` | | `solana` | Query Solana blockchain data with USD pricing — wallet balances, token portfolios with values, transaction details, NFTs, whale detection, and live network stats. Uses Solana RPC + CoinGecko. No API key required. | `blockchain/solana` | +## creative + +| Skill | Description | Path | +|-------|-------------|------| +| `blender-mcp` | Control Blender directly from Hermes via socket connection to the blender-mcp addon. Create 3D objects, materials, animations, and run arbitrary Blender Python. | `creative/blender-mcp` | +| `meme-generation` | Generate real meme images by picking a template and overlaying text with Pillow. Produces actual .png meme files. | `creative/meme-generation` | + ## email | Skill | Description | Path | @@ -32,16 +40,29 @@ Official optional skills live in the repository under `optional-skills/`. Instal |-------|-------------|------| | `neuroskill-bci` | Connect to a running NeuroSkill instance and incorporate the user's real-time cognitive and emotional state (focus, relaxation, mood, cognitive load, drowsiness, heart rate, HRV, sleep staging, and 40+ derived EXG scores) into responses. Requires a BCI wearable (Muse 2/S or Open… | `health/neuroskill-bci` | +## mcp + +| Skill | Description | Path | +|-------|-------------|------| +| `fastmcp` | Build, test, inspect, install, and deploy MCP servers with FastMCP in Python. | `mcp/fastmcp` | + ## migration | Skill | Description | Path | |-------|-------------|------| | `openclaw-migration` | Migrate a user's OpenClaw customization footprint into Hermes Agent. Imports Hermes-compatible memories, SOUL.md, command allowlists, user skills, and selected workspace assets from ~/.openclaw, then reports exactly what could not be migrated and why. | `migration/openclaw-migration` | +## productivity + +| Skill | Description | Path | +|-------|-------------|------| +| `telephony` | Give Hermes phone capabilities — provision a Twilio number, send/receive SMS/MMS, make direct calls, and place AI-driven outbound calls through Bland.ai or Vapi. | `productivity/telephony` | + ## research | Skill | Description | Path | |-------|-------------|------| +| `bioinformatics` | Gateway to 400+ bioinformatics skills from bioSkills and ClawBio. Covers genomics, transcriptomics, single-cell, variant calling, pharmacogenomics, metagenomics, structural biology. | `research/bioinformatics` | | `qmd` | Search personal knowledge bases, notes, docs, and meeting transcripts locally using qmd — a hybrid retrieval engine with BM25, vector search, and LLM reranking. Supports CLI and MCP integration. | `research/qmd` | ## security @@ -49,3 +70,5 @@ Official optional skills live in the repository under `optional-skills/`. Instal | Skill | Description | Path | |-------|-------------|------| | `1password` | Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in, and reading/injecting secrets for commands. | `security/1password` | +| `oss-forensics` | Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories. Covers deleted commit recovery, force-push detection, IOC extraction. | `security/oss-forensics` | +| `sherlock` | OSINT username search across 400+ social networks. Hunt down social media accounts by username. | `security/sherlock` | diff --git a/website/docs/reference/skills-catalog.md b/website/docs/reference/skills-catalog.md index 7e128f11f..4f6889b09 100644 --- a/website/docs/reference/skills-catalog.md +++ b/website/docs/reference/skills-catalog.md @@ -30,6 +30,14 @@ Skills for spawning and orchestrating autonomous AI coding agents and multi-agen | `hermes-agent-spawning` | Spawn additional Hermes Agent instances as autonomous subprocesses for independent long-running tasks. Supports non-interactive one-shot mode (-q) and interactive PTY mode for multi-turn collaboration. Different from delegate_task — this runs a full separate hermes process. | `autonomous-ai-agents/hermes-agent` | | `opencode` | Delegate coding tasks to OpenCode CLI agent for feature implementation, refactoring, PR review, and long-running autonomous sessions. Requires the opencode CLI installed and authenticated. | `autonomous-ai-agents/opencode` | +## data-science + +Skills for data science workflows — interactive exploration, Jupyter notebooks, data analysis, and visualization. + +| Skill | Description | Path | +|-------|-------------|------| +| `jupyter-live-kernel` | Use a live Jupyter kernel for stateful, iterative Python execution via hamelnb. Load this skill when the task involves exploration, iteration, or inspecting intermediate results. | `data-science/jupyter-live-kernel` | + ## creative Creative content generation — ASCII art, hand-drawn style diagrams, and visual design tools. @@ -44,7 +52,8 @@ Creative content generation — ASCII art, hand-drawn style diagrams, and visual | Skill | Description | Path | |-------|-------------|------| -| `dogfood` | Systematic exploratory QA testing of web applications — find bugs, capture evidence, and generate structured reports | `dogfood` | +| `dogfood` | Systematic exploratory QA testing of web applications — find bugs, capture evidence, and generate structured reports. | `dogfood/dogfood` | +| `hermes-agent-setup` | Help users configure Hermes Agent — CLI usage, setup wizard, model/provider selection, tools, skills, voice/STT/TTS, gateway, and troubleshooting. | `dogfood/hermes-agent-setup` | ## email @@ -76,6 +85,14 @@ GitHub workflow skills for managing repositories, pull requests, code reviews, i | `github-pr-workflow` | Full pull request lifecycle — create branches, commit changes, open PRs, monitor CI status, auto-fix failures, and merge. Works with gh CLI or falls back to git + GitHub REST API via curl. | `github/github-pr-workflow` | | `github-repo-management` | Clone, create, fork, configure, and manage GitHub repositories. Manage remotes, secrets, releases, and workflows. Works with gh CLI or falls back to git + GitHub REST API via curl. | `github/github-repo-management` | +## inference-sh + +Skills for AI app execution via inference.sh cloud platform. + +| Skill | Description | Path | +|-------|-------------|------| +| `inference-sh-cli` | Run 150+ AI apps via inference.sh CLI (infsh) — image generation, video creation, LLMs, search, 3D, social automation. | `inference-sh/cli` | + ## leisure | Skill | Description | Path | @@ -102,6 +119,14 @@ Skills for working with media content — YouTube transcripts, GIF search, music | `songsee` | Generate spectrograms and audio feature visualizations (mel, chroma, MFCC, tempogram, etc.) from audio files via CLI. Useful for audio analysis, music production debugging, and visual documentation. | `media/songsee` | | `youtube-content` | Fetch YouTube video transcripts and transform them into structured content (chapters, summaries, threads, blog posts). | `media/youtube-content` | +## mlops + +General-purpose ML operations tools — model hub management, dataset operations, and workflow orchestration. + +| Skill | Description | Path | +|-------|-------------|------| +| `huggingface-hub` | Hugging Face Hub CLI (hf) — search, download, and upload models and datasets, manage repos, deploy inference endpoints. | `mlops/huggingface-hub` | + ## mlops/cloud GPU cloud providers and serverless compute platforms for ML workloads. @@ -205,6 +230,7 @@ Skills for document creation, presentations, spreadsheets, and other productivit | Skill | Description | Path | |-------|-------------|------| | `google-workspace` | Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration via Python. Uses OAuth2 with automatic token refresh. No external binaries needed — runs entirely with Google's Python client libraries in the Hermes venv. | `productivity/google-workspace` | +| `linear` | Manage Linear issues, projects, and teams via the GraphQL API. Create, update, search, and organize issues. | `productivity/linear` | | `nano-pdf` | Edit PDFs with natural-language instructions using the nano-pdf CLI. Modify text, fix typos, update titles, and make content changes to specific pages without manual editing. | `productivity/nano-pdf` | | `notion` | Notion API for creating and managing pages, databases, and blocks via curl. Search, create, update, and query Notion workspaces directly from the terminal. | `productivity/notion` | | `ocr-and-documents` | Extract text from PDFs and scanned documents. Use web_extract for remote URLs, pymupdf for local text-based PDFs, marker-pdf for OCR/scanned docs. For DOCX use python-docx, for PPTX see the powerpoint skill. | `productivity/ocr-and-documents` | @@ -220,6 +246,7 @@ Skills for academic research, paper discovery, literature review, domain reconna | `blogwatcher` | Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI. Add blogs, scan for new articles, and track what you've read. | `research/blogwatcher` | | `domain-intel` | Passive domain reconnaissance using Python stdlib. Subdomain discovery, SSL certificate inspection, WHOIS lookups, DNS records, domain availability checks, and bulk multi-domain analysis. No API keys required. | `research/domain-intel` | | `duckduckgo-search` | Free web search via DuckDuckGo — text, news, images, videos. No API key needed. Use the Python DDGS library or CLI to search, then web_extract for full content. | `research/duckduckgo-search` | +| `parallel-cli` | Optional vendor skill for Parallel CLI — agent-native web search, extraction, deep research, enrichment, FindAll, and monitoring. | `research/parallel-cli` | | `ml-paper-writing` | Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, reviewer guidelines, and citation verificatio… | `research/ml-paper-writing` | | `polymarket` | Query Polymarket prediction market data — search markets, get prices, orderbooks, and price history. Read-only via public REST APIs, no API key needed. | `research/polymarket` | @@ -231,6 +258,14 @@ Skills for controlling smart home devices — lights, switches, sensors, and hom |-------|-------------|------| | `openhue` | Control Philips Hue lights, rooms, and scenes via the OpenHue CLI. Turn lights on/off, adjust brightness, color, color temperature, and activate scenes. | `smart-home/openhue` | +## social-media + +Skills for interacting with social platforms — posting, reading, monitoring, and account operations. + +| Skill | Description | Path | +|-------|-------------|------| +| `xitter` | Interact with X/Twitter via the x-cli terminal client using official X API credentials. | `social-media/xitter` | + ## software-development | Skill | Description | Path | diff --git a/website/docs/user-guide/messaging/discord.md b/website/docs/user-guide/messaging/discord.md index c36e681f4..0c2148c59 100644 --- a/website/docs/user-guide/messaging/discord.md +++ b/website/docs/user-guide/messaging/discord.md @@ -239,6 +239,12 @@ DISCORD_ALLOWED_USERS=284102345871466496 # Multiple allowed users (comma-separated) # DISCORD_ALLOWED_USERS=284102345871466496,198765432109876543 + +# Optional: respond without @mention (default: true = require mention) +# DISCORD_REQUIRE_MENTION=false + +# Optional: channels where bot responds without @mention (comma-separated channel IDs) +# DISCORD_FREE_RESPONSE_CHANNELS=1234567890,9876543210 ``` Optional behavior settings in `~/.hermes/config.yaml`: diff --git a/website/docs/user-guide/messaging/signal.md b/website/docs/user-guide/messaging/signal.md index 51d8f9629..ceebc3515 100644 --- a/website/docs/user-guide/messaging/signal.md +++ b/website/docs/user-guide/messaging/signal.md @@ -234,4 +234,5 @@ The adapter monitors the SSE connection and automatically reconnects if: | `SIGNAL_ACCOUNT` | Yes | — | Bot phone number (E.164) | | `SIGNAL_ALLOWED_USERS` | No | — | Comma-separated phone numbers/UUIDs | | `SIGNAL_GROUP_ALLOWED_USERS` | No | — | Group IDs to monitor, or `*` for all (omit to disable groups) | +| `SIGNAL_ALLOW_ALL_USERS` | No | `false` | Allow any user to interact (skip allowlist) | | `SIGNAL_HOME_CHANNEL` | No | — | Default delivery target for cron jobs | diff --git a/website/docs/user-guide/messaging/slack.md b/website/docs/user-guide/messaging/slack.md index 4c4d714b5..a40ba470f 100644 --- a/website/docs/user-guide/messaging/slack.md +++ b/website/docs/user-guide/messaging/slack.md @@ -156,6 +156,7 @@ SLACK_ALLOWED_USERS=U01ABC2DEF3 # Comma-separated Member IDs # Optional SLACK_HOME_CHANNEL=C01234567890 # Default channel for cron/scheduled messages +SLACK_HOME_CHANNEL_NAME=general # Human-readable name for the home channel (optional) ``` Or run the interactive setup: