Skip to content

Commit 0a07614

Browse files
Merge pull request #9 from OnlyTerp/devin/1777576569-hermes-guide-refresh
* docs: refresh Hermes guide for v0.12 * docs: address review feedback * docs: fix contributing layout reference * docs: update outreach part count * docs: align quickstart env with telegram template * docs: align quickstart lightrag keys * docs: add openai provider to cost template * docs: normalize routing model identifiers * docs: keep github mcp package consistent --------- Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2 parents ca75386 + 2627ba7 commit 0a07614

38 files changed

Lines changed: 684 additions & 253 deletions

.github/markdown-link-check.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
{
22
"ignorePatterns": [
33
{ "pattern": "^https://t.me/" },
4-
{ "pattern": "^https://example.com/" },
54
{ "pattern": "^https://install.hermes.nous.ai" },
65
{ "pattern": "^https://langfuse.yourdomain.com" },
76
{ "pattern": "^https://hermes.yourdomain.com" },

CHANGELOG.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,27 @@
22

33
Dated list of meaningful guide updates. Roughly [Keep a Changelog](https://keepachangelog.com) flavored.
44

5+
## 2026-04-30 — Hermes v0.11/v0.12 Refresh
6+
7+
### Added
8+
- **Part 22 — Latest Power Moves** covering Curator, TUI steering habits, context-file hygiene, plugins, auxiliary models, cron chaining, and the v0.12 upgrade checklist
9+
- Curator guidance in Part 5, including dry-run, scheduling, pin/archive behavior, and how it differs from skills/memory/context files
10+
- v0.12 platform coverage for QQBot, Tencent Yuanbao, and Microsoft Teams as a plugin-shipped gateway
11+
- AWS Bedrock, Azure AI Foundry, LM Studio, GMI Cloud, Tencent TokenHub, MiniMax OAuth, Gemini OAuth, and remote model catalog notes in Part 9
12+
- Vercel Sandbox coverage in Part 21
13+
14+
### Changed
15+
- README "What's New" now reflects landed v0.11.0 and v0.12.0 releases instead of speculative post-v0.10 PR tracking
16+
- Part 12 updated for dashboard Chat, Models tab, plugins, Curator controls, and `web,pty` install requirements
17+
- Part 14 updated for `/steer`, `/queue`, `/background`, `/busy`, and current Fast Mode language
18+
- Part 18 updated for orchestrator-role subagents and file coordination
19+
- Part 19 updated with MCP/plugin/dashboard threat surfaces and v0.12 hardline block guidance
20+
- Part 20 updated to prefer the bundled Langfuse observability plugin and auxiliary routing
21+
22+
### Removed
23+
- Stale "Cooking on main" framing and example.com disclosure placeholder
24+
- Old Gemini CLI install requirement for Gemini OAuth
25+
526
## 2026-04-17 — Wizard + Reference Architectures + CI
627

728
### Added

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ This guide is built in public. PRs welcome.
3737
├── ECOSYSTEM.md
3838
├── ROADMAP.md
3939
├── LICENSE
40-
├── part1-setup.md … part21-remote-sandboxes.md
40+
├── part1-setup.md … part22-latest-power-moves.md
4141
├── diagrams/architecture.md
4242
├── skills/
4343
│ ├── README.md

ECOSYSTEM.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -6,31 +6,31 @@ The canonical "where do I find X for Hermes" directory. Maintained alongside the
66

77
## MCP Servers Worth Installing
88

9-
### Official (Anthropic-maintained)
10-
- [`@modelcontextprotocol/server-github`](https://github.com/modelcontextprotocol/servers/tree/main/src/github) — PRs, issues, code search, Actions
9+
### Official / reference
10+
- [`@modelcontextprotocol/server-github`](https://www.npmjs.com/package/@modelcontextprotocol/server-github) — PRs, issues, code search, Actions
1111
- [`@modelcontextprotocol/server-filesystem`](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem) — read/write to scoped directories
12-
- [`@modelcontextprotocol/server-postgres`](https://github.com/modelcontextprotocol/servers/tree/main/src/postgres) — read-only SQL
13-
- [`@modelcontextprotocol/server-sqlite`](https://github.com/modelcontextprotocol/servers/tree/main/src/sqlite) — local SQLite
14-
- [`@modelcontextprotocol/server-puppeteer`](https://github.com/modelcontextprotocol/servers/tree/main/src/puppeteer) — headless browser automation
12+
- [`@modelcontextprotocol/server-postgres`](https://www.npmjs.com/package/@modelcontextprotocol/server-postgres) — read-only SQL
13+
- [`@modelcontextprotocol/server-sqlite`](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/sqlite) — local SQLite
14+
- [`@modelcontextprotocol/server-puppeteer`](https://www.npmjs.com/package/@modelcontextprotocol/server-puppeteer) — headless browser automation
1515
- [`@modelcontextprotocol/server-memory`](https://github.com/modelcontextprotocol/servers/tree/main/src/memory) — lightweight KV memory
16-
- [`@modelcontextprotocol/server-google-drive`](https://github.com/modelcontextprotocol/servers/tree/main/src/gdrive) — Drive read
16+
- [`@modelcontextprotocol/server-google-drive`](https://www.npmjs.com/package/@modelcontextprotocol/server-gdrive) — Drive read
1717

1818
### First-party vendor MCPs
1919
- [`@cloudflare/mcp-server-cloudflare`](https://github.com/cloudflare/mcp-server-cloudflare) — Workers, KV, D1, R2
20-
- [`@supabase/mcp-server-supabase`](https://github.com/supabase/mcp-server-supabase) — Postgres + storage + auth
21-
- [`@stripe/mcp-server-stripe`](https://github.com/stripe/agent-sdk) — payments read + restricted writes
22-
- [`@linear/mcp-server-linear`](https://github.com/linear/linear-mcp-server) — issue tracking
23-
- [`@notion/mcp-server-notion`](https://github.com/notionhq/notion-mcp-server) — page read/write
20+
- [`@supabase/mcp-server-supabase`](https://github.com/supabase-community/supabase-mcp/tree/main/packages/mcp-server-supabase) — Postgres + storage + auth
21+
- [`@stripe/mcp-server-stripe`](https://github.com/stripe/ai/tree/main/tools/modelcontextprotocol) — payments read + restricted writes
22+
- [`Linear remote MCP`](https://linear.app/docs/mcp) — issue tracking
23+
- [`@notionhq/notion-mcp-server`](https://github.com/makenotion/notion-mcp-server) — page read/write
2424
- [`@browserbase/mcp-server`](https://github.com/browserbase/mcp-server-browserbase) — managed headless browser
2525
- [`@chromadb/mcp-server-chroma`](https://github.com/chroma-core/chroma-mcp) — vector search
2626

2727
### Community
28-
- [`mem0/mcp-server-mem0`](https://github.com/mem0ai/mem0/tree/main/mcp) — persistent cross-device memory
28+
- [`Mem0 remote MCP`](https://docs.mem0.ai/platform/mem0-mcp) — persistent cross-device memory
2929
- [`arxiv-mcp-server`](https://github.com/blazickjp/arxiv-mcp-server) — arxiv search + PDF extraction
3030
- [`mcp-server-atlassian`](https://github.com/sooperset/mcp-atlassian) — Jira + Confluence
31-
- [`mcp-server-slack`](https://github.com/modelcontextprotocol/servers/tree/main/src/slack) — message, search, profile
31+
- [`@modelcontextprotocol/server-slack`](https://github.com/modelcontextprotocol/servers-archived/tree/main/src/slack) — message, search, profile
3232
- [`dbt-mcp`](https://github.com/dbt-labs/dbt-mcp) — dbt Cloud
33-
- [`mcp-server-e2b`](https://github.com/e2b-dev/e2b-mcp) — disposable Python sandboxes
33+
- [`e2b-dev/mcp-server`](https://github.com/e2b-dev/mcp-server) — disposable Python sandboxes
3434
- [`mcp-obsidian`](https://github.com/MarkusPfundstein/mcp-obsidian) — your Obsidian vault
3535

3636
See [Part 17](./part17-mcp-servers.md) for install patterns and trust model guidance.
@@ -74,7 +74,7 @@ See [Part 20](./part20-observability.md).
7474

7575
## Security research / CVEs of note (2026)
7676

77-
- **Comment and Control (2026-04-15)** — cross-vendor prompt-injection via GitHub PR titles hitting Claude Code, Gemini CLI, GitHub Copilot Agent. [Disclosure thread](https://example.com/disclosure).
77+
- **Comment and Control (2026-04-15)** — cross-vendor prompt-injection via GitHub PR titles hitting Claude Code, Gemini CLI, GitHub Copilot Agent. See the defensive write-up referenced in [Part 19](./part19-security-playbook.md).
7878
- **MCP stdio poisoning** — untrusted npm packages that proxy stdio MCP traffic. Mitigated by pinning versions + Socket.dev/Semgrep audits.
7979
- **Webhook replay attacks** — a reminder that HMAC + TTL together, not HMAC alone, prevents replay.
8080

README-ja.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
> [英語版はこちら](./README.md) · このページは入口の要約。本文の章は英語のまま。
44
5-
[NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)(v0.10.0+)向けの実戦ガイド + インストール可能な成果物(Skills・設定テンプレ・インフラスクリプト)。
5+
[NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)(v0.12.0 まで反映)向けの実戦ガイド + インストール可能な成果物(Skills・設定テンプレ・インフラスクリプト)。
66

77
## ワンコマンドで起動
88

@@ -15,7 +15,7 @@ curl -sSL https://raw.githubusercontent.com/OnlyTerp/hermes-optimization-guide/m
1515

1616
## 主なコンテンツ
1717

18-
- **21 章の本文**`part1``part21`) — LightRAG、Telegram、MCP、セキュリティ、可観測性、リモートサンドボックス
18+
- **23 章の本文**README 内の章 + `part6``part22`) — Curator、TUI、プラグイン、LightRAG、Telegram、MCP、セキュリティ、可観測性、リモートサンドボックス
1919
- **13 個のインストール可能 Skill**`skills/`) — 監査、バックアップ、依存スキャン、コストレポート、Telegram トリアージ、PR レビュー、受信トレイ整理、Hermes 週報、スパムフィルタ、会議準備 など
2020
- **5 つのプロダクション設定テンプレ**`templates/config/`) — minimum / telegram-bot / production / cost-optimized / security-hardened
2121
- **インフラ一式**`templates/compose/`, `templates/caddy/`, `templates/systemd/`, `scripts/`) — Langfuse セルフホスト、Caddy リバースプロキシ、systemd 強化、VPS ブートストラップ

README-zh.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
> [English 完整版](./README.md) · 本页是入口摘要,章节正文仍为英文。
44
5-
实用指南 + 可安装制品(Skills、配置模板、基础设施脚本),针对 [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)(v0.10.0+)。
5+
实用指南 + 可安装制品(Skills、配置模板、基础设施脚本),针对 [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)当前覆盖到 v0.12.0)。
66

77
## 一键起步
88

@@ -15,7 +15,7 @@ curl -sSL https://raw.githubusercontent.com/OnlyTerp/hermes-optimization-guide/m
1515

1616
## 内容一览
1717

18-
- **21 章中文正文**`part1``part21`) — LightRAG、Telegram、MCP、安全、可观测性、远程沙箱
18+
- **23 章正文**README 内章节 + `part6``part22`) — Curator、TUI、插件、LightRAG、Telegram、MCP、安全、可观测性、远程沙箱
1919
- **13 个可安装 Skill**`skills/`) — 审计、备份、依赖扫描、成本报告、Telegram 分类、PR 审查、收件箱分类、Hermes 周报、垃圾过滤、会议准备 等
2020
- **5 套生产配置模板**`templates/config/`) — minimum / telegram-bot / production / cost-optimized / security-hardened
2121
- **基础设施**`templates/compose/`, `templates/caddy/`, `templates/systemd/`, `scripts/`) — Langfuse 自托管、Caddy 反代、systemd 硬化、VPS 引导脚本

0 commit comments

Comments
 (0)