hermes - 💡(How to fix) Fix [i18n] Thai Translation: Guides Part d - use-soul-with-hermes, use-voice-mode-with-hermes, webhook-github-pr-review, work-with-skills [1 participants]
ON THIS PAGE
Recommended Tools
×6Utilities matched from this issue’s tags and category — try them while you read without losing context.
GitHub issue graph ai analysis
Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.
The report is written in English Markdown for sharing and archival.
Helpful · Quick feedback
Error Message
I keep getting a docker permission error. Help me debug it.
- "Read the last error again"
Root Cause
จากนั้นดำเนินการแบบ hands-free ต่อไป:
- "Read the last error again"
- "Explain the root cause in simpler terms"
- "Now give me the exact fix"
Code Example
~/.hermes/SOUL.md
---
$HERMES_HOME/SOUL.md
---
You are direct, calm, and technically precise.
Prefer substance over politeness theater.
Push back clearly when an idea is weak.
Keep answers compact unless deeper detail is useful.
---
You are a pragmatic senior engineer.
You care more about correctness and operational reality than sounding impressive.
## Style
- Be direct
- Be concise unless complexity requires depth
- Say when something is a bad idea
- Prefer practical tradeoffs over idealized abstractions
## Avoid
- Sycophancy
- Hype language
- Overexplaining obvious things
---
You are a thoughtful research collaborator.
You are curious, honest about uncertainty, and excited by unusual ideas.
## Style
- Explore possibilities without pretending certainty
- Distinguish speculation from evidence
- Ask clarifying questions when the idea space is underspecified
- Prefer conceptual depth over shallow completeness
---
You are a patient technical teacher.
You care about understanding, not performance.
## Style
- Explain clearly
- Use examples when they help
- Do not assume prior knowledge unless the user signals it
- Build from intuition to details
---
You are a rigorous reviewer.
You are fair, but you do not soften important criticism.
## Style
- Point out weak assumptions directly
- Prioritize correctness over harmony
- Be explicit about risks and tradeoffs
- Prefer blunt clarity to vague diplomacy
---
# Identity
ใครคือ Hermes
# Style
Hermes ควรมีน้ำเสียงอย่างไร
# Avoid
Hermes ไม่ควรทำอะไร
# Defaults
Hermes ควรมีพฤติกรรมอย่างไรเมื่อเกิดความคลุมเครือ
---
nano ~/.hermes/SOUL.md
---
vim ~/.hermes/SOUL.md
---
hermes
---
What tools do you have available?
---
pip install "hermes-agent[voice]"
---
pip install "hermes-agent[messaging]"
---
pip install "hermes-agent[tts-premium]"
---
python -m pip install -U neutts[all]
---
pip install "hermes-agent[all]"
---
brew install portaudio ffmpeg opus
brew install espeak-ng
---
sudo apt install portaudio19-dev ffmpeg libopus0
sudo apt install espeak-ng
---
# Cloud STT options (local needs no key)
GROQ_API_KEY=***
VOICE_TOOLS_OPENAI_KEY=***
# Premium TTS (optional)
ELEVENLABS_API_KEY=***
---
python -m pip install -U neutts[all]
---
voice:
record_key: "ctrl+b"
max_recording_seconds: 120
auto_tts: false
beep_enabled: true
silence_threshold: 200
silence_duration: 3.0
stt:
provider: "local"
local:
model: "base"
tts:
provider: "edge"
edge:
voice: "en-US-AriaNeural"
---
tts:
provider: "neutts"
neutts:
ref_audio: ''
ref_text: ''
model: neuphonic/neutts-air-q4-gguf
device: cpu
---
hermes
---
/voice on
---
/voice
/voice on
/voice off
/voice tts
/voice status
---
I keep getting a docker permission error. Help me debug it.
---
voice:
silence_threshold: 250
---
voice:
silence_duration: 4.0
---
voice:
record_key: "ctrl+space"
---
hermes gateway
---
/voice on
---
/voice tts
---
/voice join
/voice leave
/voice status
---
platforms:
webhook:
enabled: true
extra:
port: 8644 # default; change if another service occupies this port
rate_limit: 30 # max requests per minute per route (not a global cap)
routes:
github-pr-review:
secret: "your-webhook-secret-here" # must match the GitHub webhook secret exactly
events:
- pull_request
# The agent is instructed to fetch the actual diff before reviewing.
# {number} and {repository.full_name} are resolved from the GitHub payload.
prompt: |
A pull request event was received (action: {action}).
PR #{number}: {pull_request.title}
Author: {pull_request.user.login}
Branch: {pull_request.head.ref} → {pull_request.base.ref}
Description: {pull_request.body}
URL: {pull_request.html_url}
If the action is "closed" or "labeled", stop here and do not post a comment.
Otherwise:
1. Run: gh pr diff {number} --repo {repository.full_name}
2. Review the code changes for correctness, security issues, and clarity.
3. Write a concise, actionable review comment and post it.
deliver: github_comment
deliver_extra:
repo: "{repository.full_name}"
pr_number: "{number}"
---
hermes gateway
---
[webhook] Listening on 0.0.0.0:8644 - routes: github-pr-review
---
curl http://localhost:8644/health
# {"status": "ok", "platform": "webhook"}
---
tail -f "${HERMES_HOME:-$HOME/.hermes}/logs/gateway.log"
---
ngrok http 8644
---
SECRET="your-webhook-secret-here"
BODY='{"action":"opened","number":99,"pull_request":{"title":"Test PR","body":"Adds a feature.","user":{"login":"testuser"},"head":{"ref":"feat/x"},"base":{"ref":"main"},"html_url":"https://github.com/org/repo/pull/99"},"repository":{"full_name":"org/repo"}}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print "sha256="$2}')
curl -s -X POST http://localhost:8644/webhooks/github-pr-review \
-H "Content-Type: application/json" \
-H "X-GitHub-Event: pull_request" \
-H "X-Hub-Signature-256: $SIG" \
-d "$BODY"
# Expected: {"status":"accepted","route":"github-pr-review","event":"pull_request","delivery_id":"..."}
---
tail -f "${HERMES_HOME:-$HOME/.hermes}/logs/gateway.log"
---
platforms:
webhook:
enabled: true
extra:
routes:
github-pr-review:
secret: "your-webhook-secret-here"
events: [pull_request]
prompt: |
A pull request event was received (action: {action}).
PR #{number}: {pull_request.title} by {pull_request.user.login}
URL: {pull_request.html_url}
If the action is "closed" or "labeled", stop here and do not post a comment.
Otherwise:
1. Run: gh pr diff {number} --repo {repository.full_name}
2. Review the diff using your review guidelines.
3. Write a concise, actionable review comment and post it.
skills:
- review
deliver: github_comment
deliver_extra:
repo: "{repository.full_name}"
pr_number: "{number}"
---
# Inside platforms.webhook.extra.routes.<route-name>:
# Slack
deliver: slack
deliver_extra:
chat_id: "C0123456789" # Slack channel ID (omit to use the configured home channel)
# Discord
deliver: discord
deliver_extra:
chat_id: "987654321012345678" # Discord channel ID (omit to use home channel)
---
events:
- Merge Request Hook
---
platforms:
webhook:
enabled: true
extra:
host: "0.0.0.0" # bind address (default: 0.0.0.0)
port: 8644 # listen port (default: 8644)
secret: "" # optional global fallback secret
rate_limit: 30 # requests per minute per route
max_body_bytes: 1048576 # payload size limit in bytes (default: 1 MB)
routes:
<route-name>:
secret: "required-per-route"
events: [] # [] = accept all; otherwise list X-GitHub-Event values
prompt: "" # {field} / {nested.field} resolved from payload
skills: [] # first matching skill is loaded (only one)
deliver: "log" # log | github_comment | telegram | discord | slack | signal | sms
deliver_extra: {} # repo + pr_number for github_comment; chat_id for others
---
# In any chat session:
/skills
# Or from the CLI:
hermes skills list
---
ascii-art Generate ASCII art using pyfiglet, cowsay, boxes...
arxiv Search and retrieve academic papers from arXiv...
github-pr-workflow Full PR lifecycle - create branches, commit...
plan Plan mode - inspect context, write a markdown...
excalidraw Create hand-drawn style diagrams using Excalidraw...
---
# Search by keyword
/skills search docker
/skills search music
---
# Browse official optional skills
/skills browse
# Search the hub
/skills search blockchain
---
# Load a skill and give it a task
/ascii-art Make a banner that says "HELLO WORLD"
/plan Design a REST API for a todo app
/github-pr-workflow Create a PR for the auth refactor
# Just the skill name (no task) loads it and lets you describe what you need
/excalidraw
---
# Install an official optional skill
hermes skills install official/research/arxiv
# Install from the hub in a chat session
/skills install official/creative/songwriting-and-ai-music
---
# Check it's there
hermes skills list | grep arxiv
# Or in chat
/skills search arxiv
---
# Load a plugin skill by its qualified name
skill_view("superpowers:writing-plans")
# Built-in skill with the same base name is unaffected
skill_view("writing-plans")
---
metadata:
hermes:
config:
- key: tenor.api_key
description: "Tenor API key for GIF search"
prompt: "Enter your Tenor API key"
url: "https://developers.google.com/tenor/guides/quickstart"
---
# Interactive config for a specific skill
hermes skills config gif-search
# View all skill config
hermes config get skills.config
---
mkdir -p ~/.hermes/skills/my-category/my-skill
---
### 3. Add Reference Files (Optional)
Skills สามารถรวมไฟล์สนับสนุนที่ agent โหลดเมื่อจำเป็นได้:
---
อ้างอิงสิ่งเหล่านี้ใน SKILL.md ของคุณ:
---
### 4. Test It
เริ่ม session ใหม่และลองใช้ skill ของคุณ:
---
skill จะปรากฏโดยอัตโนมัติ - ไม่ต้องลงทะเบียน แค่ใส่ไว้ใน `~/.hermes/skills/` ก็ใช้งานได้แล้ว
:::info
agent ยังสามารถสร้างและอัปเดต skills ได้ด้วยตัวเองโดยใช้ `skill_manage` หลังจากแก้ปัญหาที่ซับซ้อนเสร็จแล้ว Hermes อาจเสนอให้บันทึกแนวทางนั้นเป็น skill สำหรับครั้งต่อไป ตอบตกลง - skills ที่สร้างโดย agent เหล่านี้จะบันทึก workflow ที่แม่นยำ รวมถึง pitfalls ที่ค้นพบระหว่างทาง
:::
---
## Per-Platform Skill Management
ควบคุมว่า skills ใดบ้างที่พร้อมใช้งานบนแพลตฟอร์มใด:RAW_BUFFERClick to expand / collapse
📄 guides/use-soul-with-hermes.md
sidebar_position: 7 title: "Use SOUL.md with Hermes" description: "How to use SOUL.md to shape Hermes Agent's default voice, what belongs there, and how it differs from AGENTS.md and /personality"
การใช้ SOUL.md กับ Hermes
SOUL.md คือ อัตลักษณ์หลัก (primary identity) สำหรับ instance ของ Hermes ของคุณ มันเป็นสิ่งแรกใน system prompt - มันกำหนดว่า agent คือใคร พูดอย่างไร และควรหลีกเลี่ยงอะไร
หากคุณต้องการให้ Hermes รู้สึกเหมือนผู้ช่วยคนเดิมทุกครั้งที่คุยด้วย - หรือหากคุณต้องการแทนที่บุคลิกภาพของ Hermes ทั้งหมดด้วยของคุณเอง - นี่คือไฟล์ที่คุณต้องใช้
SOUL.md ใช้สำหรับอะไร
ใช้ SOUL.md สำหรับ:
- น้ำเสียง (tone)
- บุคลิกภาพ (personality)
- รูปแบบการสื่อสาร (communication style)
- ระดับความตรงไปตรงมาหรือความอบอุ่นที่ Hermes ควรมี
- สิ่งที่ Hermes ควรหลีกเลี่ยงในเชิงรูปแบบ (stylistically)
- วิธีที่ Hermes ควรรับมือกับความไม่แน่นอน (uncertainty), ความขัดแย้ง (disagreement), และความคลุมเครือ (ambiguity)
กล่าวโดยสรุป:
SOUL.mdเกี่ยวกับว่า Hermes คือใคร และ Hermes พูดอย่างไร
SOUL.md ไม่ได้ใช้สำหรับอะไร
ห้ามใช้สำหรับ:
- ข้อกำหนดการเขียนโค้ดเฉพาะ repo (repo-specific coding conventions)
- file paths
- commands
- service ports
- architecture notes
- คำแนะนำขั้นตอนการทำงานของโปรเจกต์ (project workflow instructions)
สิ่งเหล่านี้ควรอยู่ใน AGENTS.md
กฎง่ายๆ:
- ถ้ามันควรใช้ได้ทุกที่ ให้ใส่ใน
SOUL.md - ถ้ามันเป็นของโปรเจกต์เดียว ให้ใส่ใน
AGENTS.md
ตำแหน่งที่อยู่
ปัจจุบัน Hermes ใช้เฉพาะไฟล์ SOUL ทั่วโลก (global SOUL file) สำหรับ instance ปัจจุบัน:
~/.hermes/SOUL.mdหากคุณรัน Hermes ด้วย home directory ที่กำหนดเอง มันจะเป็น:
$HERMES_HOME/SOUL.mdพฤติกรรมเมื่อรันครั้งแรก
Hermes จะสร้างไฟล์ SOUL.md เริ่มต้นให้คุณโดยอัตโนมัติ หากยังไม่มีไฟล์นี้
นั่นหมายความว่าผู้ใช้ส่วนใหญ่จะเริ่มต้นด้วยไฟล์จริงที่สามารถอ่านและแก้ไขได้ทันที
สิ่งสำคัญ:
- หากคุณมี
SOUL.mdอยู่แล้ว Hermes จะไม่เขียนทับไฟล์นั้น - หากไฟล์มีอยู่แต่ว่างเปล่า Hermes จะไม่เพิ่มข้อมูลใดๆ จากไฟล์นั้นลงใน prompt
Hermes ใช้มันอย่างไร
เมื่อ Hermes เริ่ม session มันจะอ่าน SOUL.md จาก HERMES_HOME สแกนหา pattern ของ prompt-injection, ตัดเนื้อหาหากจำเป็น, และใช้มันเป็น อัตลักษณ์ของ agent (agent identity) - ตำแหน่งที่ #1 ใน system prompt นั่นหมายความว่า SOUL.md จะแทนที่ข้อความอัตลักษณ์เริ่มต้นที่มาพร้อมกับระบบโดยสมบูรณ์
หาก SOUL.md หายไป ว่างเปล่า หรือไม่สามารถโหลดได้ Hermes จะกลับไปใช้อัตลักษณ์เริ่มต้นที่ระบบกำหนดไว้
จะไม่มีการเพิ่ม wrapper language รอบไฟล์ เนื้อหาของไฟล์เองที่สำคัญ - ให้เขียนในแบบที่คุณต้องการให้ agent ของคุณคิดและพูด
การแก้ไขครั้งแรกที่ดี
หากคุณไม่ทำอย่างอื่นเลย ให้เปิดไฟล์และเปลี่ยนเพียงไม่กี่บรรทัดเพื่อให้รู้สึกเหมือนตัวคุณเอง
ตัวอย่างเช่น:
You are direct, calm, and technically precise.
Prefer substance over politeness theater.
Push back clearly when an idea is weak.
Keep answers compact unless deeper detail is useful.เพียงเท่านี้ก็สามารถเปลี่ยนความรู้สึกของ Hermes ได้อย่างเห็นได้ชัด
รูปแบบตัวอย่าง
1. วิศวกรเชิงปฏิบัติ (Pragmatic engineer)
You are a pragmatic senior engineer.
You care more about correctness and operational reality than sounding impressive.
## Style
- Be direct
- Be concise unless complexity requires depth
- Say when something is a bad idea
- Prefer practical tradeoffs over idealized abstractions
## Avoid
- Sycophancy
- Hype language
- Overexplaining obvious things2. คู่ค้างานวิจัย (Research partner)
You are a thoughtful research collaborator.
You are curious, honest about uncertainty, and excited by unusual ideas.
## Style
- Explore possibilities without pretending certainty
- Distinguish speculation from evidence
- Ask clarifying questions when the idea space is underspecified
- Prefer conceptual depth over shallow completeness3. ครู/ผู้ให้คำอธิบาย (Teacher / explainer)
You are a patient technical teacher.
You care about understanding, not performance.
## Style
- Explain clearly
- Use examples when they help
- Do not assume prior knowledge unless the user signals it
- Build from intuition to details4. ผู้ตรวจทานที่เข้มงวด (Tough reviewer)
You are a rigorous reviewer.
You are fair, but you do not soften important criticism.
## Style
- Point out weak assumptions directly
- Prioritize correctness over harmony
- Be explicit about risks and tradeoffs
- Prefer blunt clarity to vague diplomacyอะไรที่ทำให้ SOUL.md แข็งแกร่ง?
SOUL.md ที่แข็งแกร่งคือ:
- มีความเสถียร (stable)
- สามารถนำไปใช้ได้กว้างขวาง (broadly applicable)
- เฉพาะเจาะจงในด้านน้ำเสียง (specific in voice)
- ไม่ถูกบรรจุด้วยคำสั่งชั่วคราวมากเกินไป
SOUL.md ที่อ่อนแอคือ:
- เต็มไปด้วยรายละเอียดของโปรเจกต์
- ขัดแย้งกันเอง
- พยายามจัดการทุกรูปแบบการตอบกลับ (micro-manage every response shape)
- ส่วนใหญ่เป็น filler ทั่วไป เช่น "be helpful" และ "be clear"
Hermes พยายามที่จะช่วยเหลือและชัดเจนอยู่แล้ว SOUL.md ควรเพิ่มบุคลิกภาพและสไตล์ที่แท้จริง ไม่ใช่การกล่าวซ้ำค่าเริ่มต้นที่ชัดเจน
โครงสร้างที่แนะนำ
คุณไม่จำเป็นต้องมีหัวข้อ (headings) แต่การมีจะช่วยได้
โครงสร้างง่ายๆ ที่ใช้งานได้ดี:
# Identity
ใครคือ Hermes
# Style
Hermes ควรมีน้ำเสียงอย่างไร
# Avoid
Hermes ไม่ควรทำอะไร
# Defaults
Hermes ควรมีพฤติกรรมอย่างไรเมื่อเกิดความคลุมเครือSOUL.md เทียบกับ /personality
ทั้งสองอย่างนี้เสริมกัน
ใช้ SOUL.md สำหรับ baseline ที่คงทนของคุณ
ใช้ /personality สำหรับการสลับโหมดชั่วคราว
ตัวอย่าง:
- SOUL เริ่มต้นของคุณคือเชิงปฏิบัติและตรงไปตรงมา
- จากนั้นสำหรับการ session หนึ่ง คุณใช้
/personality teacher - ภายหลังคุณสลับกลับโดยไม่ต้องเปลี่ยนไฟล์ base voice ของคุณ
SOUL.md เทียบกับ AGENTS.md
นี่คือข้อผิดพลาดที่พบบ่อยที่สุด
ใส่สิ่งนี้ใน SOUL.md
- “Be direct.”
- “Avoid hype language.”
- “Prefer short answers unless depth helps.”
- “Push back when the user is wrong.”
ใส่สิ่งนี้ใน AGENTS.md
- “Use pytest, not unittest.”
- “Frontend lives in
frontend/.” - “Never edit migrations directly.”
- “The API runs on port 8000.”
วิธีแก้ไข
nano ~/.hermes/SOUL.mdหรือ
vim ~/.hermes/SOUL.mdจากนั้นให้รีสตาร์ท Hermes หรือเริ่ม session ใหม่
Workflow ในทางปฏิบัติ
- เริ่มต้นด้วยไฟล์ default ที่ถูก seed มา
- ตัดส่วนใดๆ ที่ไม่รู้สึกว่าเป็นน้ำเสียงที่คุณต้องการ
- เพิ่ม 4-8 บรรทัดที่กำหนด tone และ default อย่างชัดเจน
- คุยกับ Hermes สักพัก
- ปรับปรุงตามสิ่งที่ยังรู้สึกว่าไม่ถูกต้อง
แนวทางแบบทำซ้ำ (iterative approach) นี้ทำงานได้ดีกว่าการพยายามออกแบบบุคลิกภาพที่สมบูรณ์แบบในครั้งเดียว
การแก้ไขปัญหา (Troubleshooting)
ฉันแก้ไข SOUL.md แล้ว แต่ Hermes ยังคงมีน้ำเสียงเดิม
ตรวจสอบ:
- คุณแก้ไข
~/.hermes/SOUL.mdหรือ$HERMES_HOME/SOUL.md - ไม่ใช่
SOUL.mdที่อยู่ใน repo ท้องถิ่น - ไฟล์ไม่ได้ว่างเปล่า
- คุณได้รีสตาร์ท session หลังการแก้ไขแล้ว
- ไม่มี overlay ของ
/personalityเข้ามาครอบงำผลลัพธ์
Hermes เพิกเฉยต่อบางส่วนของ SOUL.md ของฉัน
สาเหตุที่เป็นไปได้:
- คำสั่งที่มีลำดับความสำคัญสูงกว่ากำลังเขียนทับมัน
- ไฟล์มีคำแนะนำที่ขัดแย้งกัน
- ไฟล์ยาวเกินไปและถูกตัดทอน (truncated)
- ข้อความบางส่วนคล้ายกับ prompt-injection content และอาจถูกบล็อกหรือเปลี่ยนแปลงโดย scanner
SOUL.md ของฉันกลายเป็นเฉพาะโปรเจกต์มากเกินไป
ย้ายคำแนะนำของโปรเจกต์ไปที่ AGENTS.md และให้ SOUL.md มุ่งเน้นไปที่อัตลักษณ์และสไตล์
เอกสารที่เกี่ยวข้อง
📄 guides/use-voice-mode-with-hermes.md
sidebar_position: 8 title: "Use Voice Mode with Hermes" description: "A practical guide to setting up and using Hermes voice mode across CLI, Telegram, Discord, and Discord voice channels"
Use Voice Mode with Hermes
คู่มือนี้เป็นคู่มือภาคปฏิบัติสำหรับ Voice Mode feature reference
หากหน้าฟีเจอร์อธิบายว่าโหมดเสียงทำอะไรได้ คู่มือนี้จะแสดงวิธีใช้งานให้ดีจริง ๆ
What voice mode is good for
โหมดเสียงจะมีประโยชน์เป็นพิเศษเมื่อ:
- คุณต้องการ workflow แบบ hands-free ใน CLI
- คุณต้องการการตอบกลับด้วยเสียงใน Telegram หรือ Discord
- คุณต้องการให้ Hermes อยู่ใน Discord voice channel สำหรับการสนทนาแบบสด
- คุณต้องการบันทึกไอเดียอย่างรวดเร็ว, debug, หรือการโต้ตอบไปมาขณะเดิน แทนการพิมพ์
Choose your voice mode setup
โดยพื้นฐานแล้ว Hermes มีประสบการณ์โหมดเสียงที่แตกต่างกันสามแบบ
| Mode | Best for | Platform |
|---|---|---|
| Interactive microphone loop | Personal hands-free use while coding or researching | CLI |
| Voice replies in chat | Spoken responses alongside normal messaging | Telegram, Discord |
| Live voice channel bot | Group or personal live conversation in a VC | Discord voice channels |
ลำดับที่ดีที่สุดคือ:
- ทำให้ text mode ใช้งานได้ก่อน
- เปิดใช้งาน voice replies เป็นอันดับสอง
- ย้ายไปใช้ Discord voice channels เป็นลำดับสุดท้าย หากคุณต้องการประสบการณ์แบบเต็มรูปแบบ
Step 1: make sure normal Hermes works first
ก่อนที่จะแตะต้องโหมดเสียง ให้ตรวจสอบว่า:
- Hermes สามารถเริ่มต้นได้
- provider ของคุณได้รับการตั้งค่าแล้ว
- agent สามารถตอบ prompt แบบ text ได้ตามปกติ
hermesลองถามคำถามง่าย ๆ:
What tools do you have available?หากส่วนนี้ยังไม่เสถียร ให้แก้ไข text mode ก่อน
Step 2: install the right extras
CLI microphone + playback
pip install "hermes-agent[voice]"Messaging platforms
pip install "hermes-agent[messaging]"Premium ElevenLabs TTS
pip install "hermes-agent[tts-premium]"Local NeuTTS (optional)
python -m pip install -U neutts[all]Everything
pip install "hermes-agent[all]"Step 3: install system dependencies
macOS
brew install portaudio ffmpeg opus
brew install espeak-ngUbuntu / Debian
sudo apt install portaudio19-dev ffmpeg libopus0
sudo apt install espeak-ngเหตุผลที่ต้องติดตั้งสิ่งเหล่านี้:
portaudio→ microphone input / playback สำหรับ CLI voice modeffmpeg→ audio conversion สำหรับ TTS และการส่งข้อความopus→ รองรับ Discord voice codecespeak-ng→ phonemizer backend สำหรับ NeuTTS
Step 4: choose STT and TTS providers
Hermes รองรับ speech stacks ทั้งแบบ local และ cloud
Easiest / cheapest setup
ใช้ local STT และ Edge TTS ฟรี:
- STT provider:
local - TTS provider:
edge
โดยปกติแล้วนี่คือจุดเริ่มต้นที่ดีที่สุด
Environment file example
เพิ่มใน ~/.hermes/.env:
# Cloud STT options (local needs no key)
GROQ_API_KEY=***
VOICE_TOOLS_OPENAI_KEY=***
# Premium TTS (optional)
ELEVENLABS_API_KEY=***Provider recommendations
Speech-to-text
local→ ค่าเริ่มต้นที่ดีที่สุดสำหรับความเป็นส่วนตัวและค่าใช้จ่ายศูนย์groq→ cloud transcription ที่เร็วมากopenai→ ตัวเลือกสำรองแบบเสียเงินที่ดี
Text-to-speech
edge→ ฟรีและเพียงพอสำหรับผู้ใช้ส่วนใหญ่neutts→ TTS แบบ local/on-device ฟรีelevenlabs→ คุณภาพดีที่สุดopenai→ ตัวเลือกที่สมดุลที่ดีmistral→ รองรับหลายภาษา, Native Opus
If you use hermes setup
หากคุณเลือก NeuTTS ใน setup wizard, Hermes จะตรวจสอบว่า neutts ได้ถูกติดตั้งแล้วหรือไม่ หากขาดไป, wizard จะแจ้งว่า NeuTTS ต้องการ Python package neutts และ system package espeak-ng, เสนอให้ติดตั้งให้คุณ, ติดตั้ง espeak-ng ด้วย package manager ของ platform ของคุณ, และรัน:
python -m pip install -U neutts[all]หากคุณข้ามการติดตั้งนั้นหรือมันล้มเหลว, wizard จะกลับไปใช้ Edge TTS
Step 5: recommended config
voice:
record_key: "ctrl+b"
max_recording_seconds: 120
auto_tts: false
beep_enabled: true
silence_threshold: 200
silence_duration: 3.0
stt:
provider: "local"
local:
model: "base"
tts:
provider: "edge"
edge:
voice: "en-US-AriaNeural"นี่คือค่า default ที่ปลอดภัยและดีสำหรับคนส่วนใหญ่
หากคุณต้องการ local TTS แทน, ให้เปลี่ยนบล็อก tts เป็น:
tts:
provider: "neutts"
neutts:
ref_audio: ''
ref_text: ''
model: neuphonic/neutts-air-q4-gguf
device: cpuUse case 1: CLI voice mode
Turn it on
เริ่มต้น Hermes:
hermesภายใน CLI:
/voice onRecording flow
Default key:
Ctrl+B
Workflow:
- กด
Ctrl+B - พูด
- รอให้ระบบตรวจจับความเงียบเพื่อหยุดบันทึกโดยอัตโนมัติ
- Hermes ถอดเสียงและตอบกลับ
- หาก TTS เปิดอยู่, มันจะพูดคำตอบ
- loop สามารถเริ่มใหม่โดยอัตโนมัติสำหรับการใช้งานต่อเนื่อง
Useful commands
/voice
/voice on
/voice off
/voice tts
/voice statusGood CLI workflows
Walk-up debugging
พูดว่า:
I keep getting a docker permission error. Help me debug it.จากนั้นดำเนินการแบบ hands-free ต่อไป:
- "Read the last error again"
- "Explain the root cause in simpler terms"
- "Now give me the exact fix"
Research / brainstorming
เหมาะสำหรับ:
- การเดินไปรอบ ๆ ขณะคิด
- การบอกไอเดียที่ยังไม่สมบูรณ์
- การขอให้ Hermes จัดโครงสร้างความคิดของคุณแบบ real time
Accessibility / low-typing sessions
หากการพิมพ์ไม่สะดวก, voice mode เป็นวิธีที่เร็วที่สุดวิธีหนึ่งในการอยู่ใน loop ของ Hermes อย่างเต็มที่
Tuning CLI behavior
Silence threshold
หาก Hermes เริ่ม/หยุดทำงานเร็วเกินไป, ให้ปรับค่า:
voice:
silence_threshold: 250ค่า threshold สูง = ความไวต่ำลง
Silence duration
หากคุณหยุดพักนานระหว่างประโยค, ให้เพิ่มค่า:
voice:
silence_duration: 4.0Record key
หาก Ctrl+B ขัดแย้งกับนิสัยการใช้ terminal หรือ tmux ของคุณ:
voice:
record_key: "ctrl+space"Use case 2: voice replies in Telegram or Discord
โหมดนี้ง่ายกว่า voice channels แบบเต็มรูปแบบ
Hermes จะยังคงเป็น chat bot ทั่วไป แต่สามารถพูดคำตอบได้
Start the gateway
hermes gatewayTurn on voice replies
ภายใน Telegram หรือ Discord:
/voice onหรือ
/voice ttsModes
| Mode | Meaning |
|---|---|
off | text only |
voice_only | speak only when the user sent voice |
all | speak every reply |
When to use which mode
/voice onหากคุณต้องการคำตอบด้วยเสียงสำหรับข้อความที่มาจากเสียงเท่านั้น/voice ttsหากคุณต้องการผู้ช่วยที่พูดตลอดเวลา
Good messaging workflows
Telegram assistant on your phone
ใช้เมื่อ:
- คุณไม่อยู่ที่เครื่องของคุณ
- คุณต้องการส่ง voice notes และรับคำตอบด้วยเสียงอย่างรวดเร็ว
- คุณต้องการให้ Hermes ทำหน้าที่เหมือนผู้ช่วยวิจัยหรือผู้ช่วยปฏิบัติการแบบพกพา
Discord DMs with spoken output
มีประโยชน์เมื่อคุณต้องการการโต้ตอบส่วนตัวโดยไม่มีพฤติกรรม mention ใน server-channel
Use case 3: Discord voice channels
นี่คือโหมดที่ล้ำหน้าที่สุด
Hermes จะเข้าร่วม Discord VC, ฟังคำพูดของผู้ใช้, ถอดเสียง, รัน agent pipeline ปกติ, และพูดคำตอบกลับเข้าไปใน channel
Required Discord permissions
นอกเหนือจากการตั้งค่า text-bot ปกติ, ให้แน่ใจว่า bot มี:
- Connect
- Speak
- preferably Use Voice Activity
และเปิดใช้งาน privileged intents ใน Developer Portal:
- Presence Intent
- Server Members Intent
- Message Content Intent
Join and leave
ใน Discord text channel ที่ bot อยู่:
/voice join
/voice leave
/voice statusWhat happens when joined
- ผู้ใช้พูดใน VC
- Hermes ตรวจจับขอบเขตของคำพูด
- transcripts จะถูกโพสต์ใน text channel ที่เกี่ยวข้อง
- Hermes ตอบกลับทั้งในรูปแบบ text และ audio
- text channel คือช่องที่ออกคำสั่ง
/voice join
Best practices for Discord VC use
- keep
DISCORD_ALLOWED_USERStight - use a dedicated bot/testing channel at first
- verify STT and TTS work in ordinary text-chat voice mode before trying VC mode
Voice quality recommendations
Best quality setup
- STT: local
large-v3or Groqwhisper-large-v3 - TTS: ElevenLabs
Best speed / convenience setup
- STT: local
baseor Groq - TTS: Edge
Best zero-cost setup
- STT: local
- TTS: Edge
Common failure modes
"No audio device found"
ติดตั้ง portaudio
"Bot joins but hears nothing"
ตรวจสอบ:
- user ID ของ Discord ของคุณอยู่ใน
DISCORD_ALLOWED_USERS - คุณไม่ได้ถูก mute
- privileged intents ถูกเปิดใช้งานแล้ว
- bot มีสิทธิ์ Connect/Speak
"It transcribes but does not speak"
ตรวจสอบ:
- การตั้งค่า TTS provider
- API key / quota สำหรับ ElevenLabs หรือ OpenAI
- การติดตั้ง
ffmpegสำหรับ Edge conversion paths
"Whisper outputs garbage"
ลอง:
- สภาพแวดล้อมที่เงียบกว่า
silence_thresholdที่สูงขึ้น- provider/model STT ที่แตกต่างกัน
- คำพูดที่สั้นลงและชัดเจนขึ้น
"It works in DMs but not in server channels"
นั่นมักจะเป็นเรื่องของ mention policy
โดยค่าเริ่มต้น, bot ต้องการ @mention ใน Discord server text channels เว้นแต่จะมีการตั้งค่าเป็นอย่างอื่น
Suggested first-week setup
หากคุณต้องการเส้นทางที่สั้นที่สุดสู่ความสำเร็จ:
- get text Hermes working
- install
hermes-agent[voice] - use CLI voice mode with local STT + Edge TTS
- then enable
/voice onin Telegram or Discord - only after that, try Discord VC mode
ลำดับนี้จะทำให้พื้นที่ในการ debug มีขนาดเล็ก
Where to read next
📄 guides/webhook-github-pr-review.md
sidebar_position: 11 sidebar_label: "GitHub PR Reviews via Webhook" title: "Automated GitHub PR Comments with Webhooks" description: "Connect Hermes to GitHub so it automatically fetches PR diffs, reviews code changes, and posts comments - triggered by webhooks with no manual prompting"
Automated GitHub PR Comments with Webhooks
คู่มือนี้จะแนะนำวิธีการเชื่อมต่อ Hermes Agent เข้ากับ GitHub เพื่อให้สามารถดึง diff ของ pull request โดยอัตโนมัติ วิเคราะห์การเปลี่ยนแปลงโค้ด และโพสต์คอมเมนต์ โดยถูกกระตุ้นโดยเหตุการณ์ webhook โดยไม่จำเป็นต้องมีการแจ้งเตือนด้วยตนเอง
เมื่อมีการเปิดหรืออัปเดต PR, GitHub จะส่ง webhook POST ไปยัง instance ของ Hermes ของคุณ Hermes จะรัน agent ด้วย prompt ที่สั่งให้ดึง diff ผ่าน gh CLI และส่ง response กลับไปยัง thread ของ PR
:::tip Want a simpler setup without a public endpoint? หากคุณไม่มี public URL หรือต้องการเริ่มต้นใช้งานอย่างรวดเร็ว ลองดู Build a GitHub PR Review Agent - ซึ่งใช้ cron jobs เพื่อ poll PRs ตามตารางเวลา ทำงานได้แม้หลัง NAT และ firewalls :::
:::info Reference docs สำหรับเอกสารอ้างอิงแพลตฟอร์ม webhook ฉบับเต็ม (ตัวเลือก config ทั้งหมด, ประเภทการส่ง, dynamic subscriptions, security model) ดูที่ Webhooks :::
:::warning Prompt injection risk Webhook payloads มีข้อมูลที่ผู้โจมตีควบคุมได้ - ชื่อ PR, commit messages, และ descriptions อาจมีคำสั่งที่เป็นอันตราย เมื่อ webhook endpoint ของคุณเปิดสู่อินเทอร์เน็ต ให้รัน gateway ในสภาพแวดล้อมแบบ sandboxed (Docker, SSH backend) ดูที่ security section ด้านล่าง :::
Prerequisites
- Hermes Agent ติดตั้งและกำลังทำงานอยู่ (
hermes gateway) ghCLI ติดตั้งและ authenticated บน gateway host (gh auth login)- URL ที่สามารถเข้าถึงได้จากสาธารณะสำหรับ Hermes instance ของคุณ (ดู Local testing with ngrok หากรันในเครื่อง)
- สิทธิ์ผู้ดูแลระบบ (Admin access) สำหรับ GitHub repository (จำเป็นสำหรับการจัดการ webhooks)
Step 1 - Enable the webhook platform
เพิ่มสิ่งต่อไปนี้ใน ~/.hermes/config.yaml:
platforms:
webhook:
enabled: true
extra:
port: 8644 # default; change if another service occupies this port
rate_limit: 30 # max requests per minute per route (not a global cap)
routes:
github-pr-review:
secret: "your-webhook-secret-here" # must match the GitHub webhook secret exactly
events:
- pull_request
# The agent is instructed to fetch the actual diff before reviewing.
# {number} and {repository.full_name} are resolved from the GitHub payload.
prompt: |
A pull request event was received (action: {action}).
PR #{number}: {pull_request.title}
Author: {pull_request.user.login}
Branch: {pull_request.head.ref} → {pull_request.base.ref}
Description: {pull_request.body}
URL: {pull_request.html_url}
If the action is "closed" or "labeled", stop here and do not post a comment.
Otherwise:
1. Run: gh pr diff {number} --repo {repository.full_name}
2. Review the code changes for correctness, security issues, and clarity.
3. Write a concise, actionable review comment and post it.
deliver: github_comment
deliver_extra:
repo: "{repository.full_name}"
pr_number: "{number}"Key fields:
| Field | Description |
|---|---|
secret (route-level) | HMAC secret สำหรับ route นี้ หากละเว้น จะใช้ค่า extra.secret global เป็นค่า fallback |
events | รายการค่าของ header X-GitHub-Event ที่ยอมรับ รายการว่างเปล่า = ยอมรับทั้งหมด |
prompt | Template; {field} และ {nested.field} จะถูก resolve จาก GitHub payload |
deliver | github_comment โพสต์ผ่าน gh pr comment ส่วน log จะเขียนลงใน gateway log |
deliver_extra.repo | Resolve เป็น e.g. org/repo จาก payload |
deliver_extra.pr_number | Resolve เป็น PR number จาก payload |
:::note The payload does not contain code
Webhook payload ของ GitHub ประกอบด้วย metadata ของ PR (title, description, branch names, URLs) แต่ ไม่รวม diff prompt ด้านบนสั่งให้ agent รัน gh pr diff เพื่อดึงการเปลี่ยนแปลงจริง terminal tool ถูกรวมอยู่ใน hermes-webhook toolset เริ่มต้น ดังนั้นจึงไม่จำเป็นต้องมีการตั้งค่าเพิ่มเติม
:::
Step 2 - Start the gateway
hermes gatewayคุณควรเห็น:
[webhook] Listening on 0.0.0.0:8644 - routes: github-pr-reviewตรวจสอบว่าทำงานได้:
curl http://localhost:8644/health
# {"status": "ok", "platform": "webhook"}Step 3 - Register the webhook on GitHub
- ไปที่ repository ของคุณ → Settings → Webhooks → Add webhook
- กรอกข้อมูล:
- Payload URL:
https://your-public-url.example.com/webhooks/github-pr-review - Content type:
application/json - Secret: ค่าเดียวกับที่คุณตั้งไว้สำหรับ
secretใน route config - Which events? → Select individual events → check Pull requests
- Payload URL:
- คลิก Add webhook
GitHub จะส่งเหตุการณ์ ping ทันทีเพื่อยืนยันการเชื่อมต่อ ซึ่งจะถูกเพิกเฉยอย่างปลอดภัย - ping ไม่อยู่ในรายการ events ของคุณ - และจะคืนค่า {"status": "ignored", "event": "ping"} มันจะถูกบันทึกเพียงระดับ DEBUG เท่านั้น ดังนั้นจึงจะไม่ปรากฏใน console ที่ระดับ log default
Step 4 - Open a test PR
สร้าง branch, push การเปลี่ยนแปลง, และเปิด PR ภายใน 30-90 วินาที (ขึ้นอยู่กับขนาด PR และ model) Hermes ควรจะโพสต์คอมเมนต์รีวิว
หากต้องการติดตามความคืบหน้าของ agent แบบเรียลไทม์:
tail -f "${HERMES_HOME:-$HOME/.hermes}/logs/gateway.log"Local testing with ngrok
หาก Hermes กำลังทำงานบน laptop ของคุณ ให้ใช้ ngrok เพื่อเปิดเผยมัน:
ngrok http 8644คัดลอก URL https://...ngrok-free.app และใช้เป็น GitHub Payload URL บน free ngrok tier URL จะเปลี่ยนทุกครั้งที่ ngrok restart - ให้อัปเดต GitHub webhook ของคุณในแต่ละ session บัญชี ngrok แบบเสียเงินจะได้ static domain
คุณสามารถ smoke-test static route ได้โดยตรงด้วย curl - ไม่ต้องมีบัญชี GitHub หรือ PR จริง
:::tip Use deliver: log when testing locally
เปลี่ยน deliver: github_comment เป็น deliver: log ใน config ของคุณขณะทดสอบ มิฉะนั้น agent จะพยายามโพสต์คอมเมนต์ไปยัง repo org/repo#99 ปลอมใน test payload ซึ่งจะล้มเหลว ให้สลับกลับไปที่ deliver: github_comment เมื่อคุณพอใจกับ output ของ prompt แล้ว
:::
SECRET="your-webhook-secret-here"
BODY='{"action":"opened","number":99,"pull_request":{"title":"Test PR","body":"Adds a feature.","user":{"login":"testuser"},"head":{"ref":"feat/x"},"base":{"ref":"main"},"html_url":"https://github.com/org/repo/pull/99"},"repository":{"full_name":"org/repo"}}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print "sha256="$2}')
curl -s -X POST http://localhost:8644/webhooks/github-pr-review \
-H "Content-Type: application/json" \
-H "X-GitHub-Event: pull_request" \
-H "X-Hub-Signature-256: $SIG" \
-d "$BODY"
# Expected: {"status":"accepted","route":"github-pr-review","event":"pull_request","delivery_id":"..."}จากนั้นดู agent ทำงาน:
tail -f "${HERMES_HOME:-$HOME/.hermes}/logs/gateway.log":::note
hermes webhook test <name> ใช้ได้เฉพาะกับ dynamic subscriptions ที่สร้างด้วย hermes webhook subscribe เท่านั้น ไม่ได้อ่าน routes จาก config.yaml
:::
Filtering to specific actions
GitHub ส่งเหตุการณ์ pull_request สำหรับหลาย actions: opened, synchronize, reopened, closed, labeled, ฯลฯ รายการ events กรองเฉพาะตามค่า header X-GitHub-Event เท่านั้น - ไม่สามารถกรองตาม action sub-type ในระดับ routing ได้
prompt ใน Step 1 จัดการเรื่องนี้แล้วโดยการสั่งให้ agent หยุดทำงานตั้งแต่เนิ่นๆ สำหรับเหตุการณ์ closed และ labeled
:::warning The agent still runs and consumes tokens
คำสั่ง "stop here" ป้องกันการรีวิวที่มีความหมาย แต่ agent ยังคงรันจนเสร็จสิ้นสำหรับทุกเหตุการณ์ pull_request ไม่ว่า action จะเป็นอะไรก็ตาม GitHub webhooks สามารถกรองได้เฉพาะตามประเภทเหตุการณ์ (pull_request, push, issues, ฯลฯ) - ไม่ใช่ตาม action sub-type (opened, closed, labeled) ไม่มี filter ระดับ routing สำหรับ sub-actions สำหรับ repo ที่มีปริมาณสูง ให้ยอมรับค่าใช้จ่ายนี้ หรือกรองที่ต้นทางด้วย GitHub Actions workflow ที่เรียก webhook URL ของคุณแบบมีเงื่อนไข
:::
There is no Jinja2 or conditional template syntax.
{field}and{nested.field}are the only substitutions supported. Anything else is passed verbatim to the agent.
Using a skill for consistent review style
โหลด Hermes skill เพื่อให้ agent มีบุคลิกภาพในการรีวิวที่สม่ำเสมอ เพิ่ม skills เข้าไปใน route ของคุณภายใน platforms.webhook.extra.routes ใน config.yaml:
platforms:
webhook:
enabled: true
extra:
routes:
github-pr-review:
secret: "your-webhook-secret-here"
events: [pull_request]
prompt: |
A pull request event was received (action: {action}).
PR #{number}: {pull_request.title} by {pull_request.user.login}
URL: {pull_request.html_url}
If the action is "closed" or "labeled", stop here and do not post a comment.
Otherwise:
1. Run: gh pr diff {number} --repo {repository.full_name}
2. Review the diff using your review guidelines.
3. Write a concise, actionable review comment and post it.
skills:
- review
deliver: github_comment
deliver_extra:
repo: "{repository.full_name}"
pr_number: "{number}"Note: Only the first skill in the list that is found is loaded. Hermes does not stack multiple skills - subsequent entries are ignored.
Sending responses to Slack or Discord instead
แทนที่ฟิลด์ deliver และ deliver_extra ภายใน route ของคุณด้วย target platform:
# Inside platforms.webhook.extra.routes.<route-name>:
# Slack
deliver: slack
deliver_extra:
chat_id: "C0123456789" # Slack channel ID (omit to use the configured home channel)
# Discord
deliver: discord
deliver_extra:
chat_id: "987654321012345678" # Discord channel ID (omit to use home channel)Target platform ต้องเปิดใช้งานและเชื่อมต่อใน gateway ด้วย หากละเว้น chat_id response จะถูกส่งไปยัง home channel ที่กำหนดค่าไว้ของ platform นั้นๆ
Valid deliver values: log · github_comment · telegram · discord · slack · signal · sms
GitLab support
Adapter เดียวกันนี้ใช้ได้กับ GitLab GitLab ใช้ X-Gitlab-Token สำหรับการตรวจสอบสิทธิ์ (plain string match, ไม่ใช่ HMAC) - Hermes จัดการให้โดยอัตโนมัติ
สำหรับการกรองเหตุการณ์, GitLab ตั้งค่า X-GitLab-Event เป็นค่าต่างๆ เช่น Merge Request Hook, Push Hook, Pipeline Hook ให้ใช้ค่า header ที่แน่นอนใน events:
events:
- Merge Request HookField ของ payload ของ GitLab แตกต่างจาก GitHub - เช่น {object_attributes.title} สำหรับชื่อ MR และ {object_attributes.iid} สำหรับหมายเลข MR วิธีที่ง่ายที่สุดในการค้นหาโครงสร้าง payload ทั้งหมดคือปุ่ม Test ของ GitLab ในการตั้งค่า webhook ของคุณ ร่วมกับ log Recent Deliveries หรืออีกทางคือ ละเว้น prompt จาก route config ของคุณ - Hermes จะส่ง full payload เป็น formatted JSON ไปยัง agent โดยตรง และ response ของ agent (ที่มองเห็นได้ใน gateway log ด้วย deliver: log) จะอธิบายโครงสร้างของมัน
Security notes
- Never use
INSECURE_NO_AUTHใน production - เพราะมันปิดการตรวจสอบ signature ทั้งหมด มันมีไว้สำหรับการพัฒนาในเครื่องเท่านั้น - Rotate your webhook secret เป็นระยะและอัปเดตทั้งใน GitHub (webhook settings) และ
config.yamlของคุณ - Rate limiting คือ 30 req/min ต่อ route โดยค่าเริ่มต้น (สามารถกำหนดค่าได้ผ่าน
extra.rate_limit) การเกินขีดจำกัดจะคืนค่า429 - Duplicate deliveries (webhook retries) จะถูก deduplicate ผ่าน 1-hour idempotency cache คีย์ cache คือ
X-GitHub-Deliveryหากมี, จากนั้นX-Request-ID, จากนั้น timestamp แบบ millisecond เมื่อไม่มี delivery ID header ใดๆ, retries จะ ไม่ ถูก deduplicate - Prompt injection: ชื่อ PR, description, และ commit messages เป็นข้อมูลที่ผู้โจมตีควบคุมได้ PR ที่เป็นอันตรายอาจพยายามบิดเบือนการกระทำของ agent ให้รัน gateway ในสภาพแวดล้อมแบบ sandboxed (Docker, VM) เมื่อเปิดสู่สาธารณะอินเทอร์เน็ต
Troubleshooting
| Symptom | Check |
|---|---|
401 Invalid signature | Secret ใน config.yaml ไม่ตรงกับ GitHub webhook secret |
404 Unknown route | ชื่อ route ใน URL ไม่ตรงกับ key ใน routes: |
429 Rate limit exceeded | เกิน 30 req/min ต่อ route - พบบ่อยเมื่อ re-delivering test events จาก UI ของ GitHub; รอหนึ่งนาที หรือเพิ่ม extra.rate_limit |
| No comment posted | gh ไม่ได้ติดตั้ง, ไม่อยู่ใน PATH, หรือไม่ได้ authenticated (gh auth login) |
| Agent runs but no comment | ตรวจสอบ gateway log - หาก output ของ agent ว่างเปล่าหรือแค่ "SKIP", การส่ง delivery ก็ยังถูกพยายาม |
| Port already in use | เปลี่ยน extra.port ใน config.yaml |
| Agent runs but reviews only the PR description | prompt ไม่ได้รวมคำสั่ง gh pr diff - เพราะ diff ไม่อยู่ใน webhook payload |
| Can't see the ping event | เหตุการณ์ที่ถูกเพิกเฉยจะคืนค่า {"status":"ignored","event":"ping"} ที่ระดับ log DEBUG เท่านั้น - ตรวจสอบ delivery log ของ GitHub (repo → Settings → Webhooks → your webhook → Recent Deliveries) |
GitHub's Recent Deliveries tab (repo → Settings → Webhooks → your webhook) แสดง header request, payload, HTTP status, และ response body ที่แน่นอนสำหรับการส่งทุกครั้ง มันเป็นวิธีที่เร็วที่สุดในการวินิจฉัยความล้มเหลวโดยไม่ต้องแตะ server logs ของคุณ
Full config reference
platforms:
webhook:
enabled: true
extra:
host: "0.0.0.0" # bind address (default: 0.0.0.0)
port: 8644 # listen port (default: 8644)
secret: "" # optional global fallback secret
rate_limit: 30 # requests per minute per route
max_body_bytes: 1048576 # payload size limit in bytes (default: 1 MB)
routes:
<route-name>:
secret: "required-per-route"
events: [] # [] = accept all; otherwise list X-GitHub-Event values
prompt: "" # {field} / {nested.field} resolved from payload
skills: [] # first matching skill is loaded (only one)
deliver: "log" # log | github_comment | telegram | discord | slack | signal | sms
deliver_extra: {} # repo + pr_number for github_comment; chat_id for othersWhat's Next?
- Cron-Based PR Reviews - poll for PRs on a schedule, no public endpoint needed
- Webhook Reference - full config reference for the webhook platform
- Build a Plugin - package review logic into a shareable plugin
- Profiles - run a dedicated reviewer profile with its own memory and config
📄 guides/work-with-skills.md
sidebar_position: 12 title: "Working with Skills" description: "Find, install, use, and create skills - on-demand knowledge that teaches Hermes new workflows"
Working with Skills
Skills คือเอกสารความรู้แบบ on-demand ที่สอนให้ Hermes จัดการงานเฉพาะอย่างได้ ตั้งแต่การสร้าง ASCII art ไปจนถึงการจัดการ GitHub PRs คู่มือนี้จะแนะนำวิธีการใช้งานในชีวิตประจำวัน
สำหรับข้อมูลอ้างอิงทางเทคนิคฉบับเต็ม ดูได้ที่ Skills System
Finding Skills
การติดตั้ง Hermes ทุกครั้งจะมาพร้อมกับ skills ที่รวมไว้แล้ว ดูว่ามีอะไรบ้าง:
# In any chat session:
/skills
# Or from the CLI:
hermes skills listสิ่งนี้จะแสดงรายการแบบย่อพร้อมชื่อและคำอธิบาย:
ascii-art Generate ASCII art using pyfiglet, cowsay, boxes...
arxiv Search and retrieve academic papers from arXiv...
github-pr-workflow Full PR lifecycle - create branches, commit...
plan Plan mode - inspect context, write a markdown...
excalidraw Create hand-drawn style diagrams using Excalidraw...Searching for a Skill
# Search by keyword
/skills search docker
/skills search musicThe Skills Hub
official optional skills (skills ที่มีขนาดใหญ่ขึ้นหรือเฉพาะทาง ซึ่งไม่ได้เปิดใช้งานโดยค่าเริ่มต้น) สามารถเข้าถึงได้ผ่าน Hub:
# Browse official optional skills
/skills browse
# Search the hub
/skills search blockchainUsing a Skill
skills ที่ติดตั้งทุกตัวจะเป็น slash command โดยอัตโนมัติ เพียงแค่พิมพ์ชื่อของมัน:
# Load a skill and give it a task
/ascii-art Make a banner that says "HELLO WORLD"
/plan Design a REST API for a todo app
/github-pr-workflow Create a PR for the auth refactor
# Just the skill name (no task) loads it and lets you describe what you need
/excalidrawคุณยังสามารถเรียกใช้ skills ผ่านการสนทนาแบบธรรมชาติได้ด้วย - เพียงแค่ขอให้ Hermes ใช้ skills เฉพาะตัว มันก็จะโหลดผ่านเครื่องมือ skill_view
Progressive Disclosure
Skills ใช้รูปแบบการโหลดที่ประหยัด token ตัว agent จะไม่โหลดทุกอย่างพร้อมกัน:
skills_list()- รายการย่อของ skills ทั้งหมด (~3k tokens) โหลดเมื่อเริ่ม sessionskill_view(name)- เนื้อหา SKILL.md ฉบับเต็มสำหรับ skills หนึ่งตัว โหลดเมื่อ agent ตัดสินใจว่าต้องการ skills นั้นskill_view(name, file_path)- ไฟล์อ้างอิงเฉพาะภายใน skills โหลดก็ต่อเมื่อจำเป็นเท่านั้น
นั่นหมายความว่า skills จะไม่เสีย token จนกว่าจะถูกใช้งานจริง
Installing from the Hub
official optional skills มาพร้อมกับ Hermes แต่ไม่ได้เปิดใช้งานโดยค่าเริ่มต้น คุณต้องติดตั้งอย่างชัดเจน:
# Install an official optional skill
hermes skills install official/research/arxiv
# Install from the hub in a chat session
/skills install official/creative/songwriting-and-ai-musicสิ่งที่เกิดขึ้น:
- ไดเรกทอรี skills จะถูกคัดลอกไปยัง
~/.hermes/skills/ - มันจะปรากฏใน output ของ
skills_listของคุณ - มันจะพร้อมใช้งานเป็น slash command
:::tip
installed skills จะมีผลใน session ใหม่ หากต้องการให้ใช้งานได้ใน session ปัจจุบัน ให้ใช้ /reset เพื่อเริ่มใหม่ หรือเพิ่ม --now เพื่อทำให้ prompt cache ไม่ถูกต้องทันที (จะเสีย token มากขึ้นใน turn ถัดไป)
:::
Verifying Installation
# Check it's there
hermes skills list | grep arxiv
# Or in chat
/skills search arxivPlugin-Provided Skills
Plugins สามารถรวม skills ของตัวเองโดยใช้ namespaced names (plugin:skill) ซึ่งป้องกันการชนกันของชื่อกับ skills ที่ติดตั้งมาให้แล้ว
# Load a plugin skill by its qualified name
skill_view("superpowers:writing-plans")
# Built-in skill with the same base name is unaffected
skill_view("writing-plans")skills ของ Plugin จะ ไม่ ถูกระบุใน system prompt และไม่ปรากฏใน skills_list พวกมันเป็นแบบ opt-in - ให้โหลดอย่างชัดเจนเมื่อคุณรู้ว่า plugin ตัวใดตัวหนึ่งมีให้ เมื่อโหลดแล้ว agent จะเห็น banner ที่แสดงรายการ skills อื่นๆ จาก plugin เดียวกัน
สำหรับวิธีการรวม skills ใน plugin ของคุณ ดูได้ที่ Build a Hermes Plugin → Bundle skills
Configuring Skill Settings
skills บางตัวจะประกาศการตั้งค่าที่ต้องการใน frontmatter ของมัน:
metadata:
hermes:
config:
- key: tenor.api_key
description: "Tenor API key for GIF search"
prompt: "Enter your Tenor API key"
url: "https://developers.google.com/tenor/guides/quickstart"เมื่อมีการโหลด skills ที่มี config เป็นครั้งแรก Hermes จะแจ้งให้คุณระบุค่าเหล่านั้น ค่าเหล่านี้จะถูกจัดเก็บใน config.yaml ภายใต้ skills.config.*
จัดการ config ของ skills จาก CLI:
# Interactive config for a specific skill
hermes skills config gif-search
# View all skill config
hermes config get skills.configCreating Your Own Skill
Skills เป็นเพียงไฟล์ markdown ที่มี YAML frontmatter การสร้างนั้นใช้เวลาไม่ถึงห้านาที
1. Create the Directory
mkdir -p ~/.hermes/skills/my-category/my-skill2. Write SKILL.md
---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
metadata:
hermes:
tags: [my-tag, automation]
category: my-category
---
# My Skill
## When to Use
Use this skill when the user asks about [specific topic] or needs to [specific task].
## Procedure
1. First, check if [prerequisite] is available
2. Run `command --with-flags`
3. Parse the output and present results
## Pitfalls
- Common failure: [description]. Fix: [solution]
- Watch out for [edge case]
## Verification
Run `check-command` to confirm the result is correct.3. Add Reference Files (Optional)
Skills สามารถรวมไฟล์สนับสนุนที่ agent โหลดเมื่อจำเป็นได้:
my-skill/
├── SKILL.md # Main skill document
├── references/
│ ├── api-docs.md # API reference the agent can consult
│ └── examples.md # Example inputs/outputs
├── templates/
│ └── config.yaml # Template files the agent can use
└── scripts/
└── setup.sh # Scripts the agent can executeอ้างอิงสิ่งเหล่านี้ใน SKILL.md ของคุณ:
For API details, load the reference: `skill_view("my-skill", "references/api-docs.md")`4. Test It
เริ่ม session ใหม่และลองใช้ skill ของคุณ:
hermes chat -q "/my-skill help me with the thing"skill จะปรากฏโดยอัตโนมัติ - ไม่ต้องลงทะเบียน แค่ใส่ไว้ใน ~/.hermes/skills/ ก็ใช้งานได้แล้ว
:::info
agent ยังสามารถสร้างและอัปเดต skills ได้ด้วยตัวเองโดยใช้ skill_manage หลังจากแก้ปัญหาที่ซับซ้อนเสร็จแล้ว Hermes อาจเสนอให้บันทึกแนวทางนั้นเป็น skill สำหรับครั้งต่อไป ตอบตกลง - skills ที่สร้างโดย agent เหล่านี้จะบันทึก workflow ที่แม่นยำ รวมถึง pitfalls ที่ค้นพบระหว่างทาง
:::
Per-Platform Skill Management
ควบคุมว่า skills ใดบ้างที่พร้อมใช้งานบนแพลตฟอร์มใด:
hermes skillsสิ่งนี้จะเปิด TUI แบบโต้ตอบที่คุณสามารถเปิดหรือปิด skills ตามแพลตฟอร์ม (CLI, Telegram, Discord, ฯลฯ) มีประโยชน์เมื่อคุณต้องการให้ skills บางตัวใช้งานได้เฉพาะในบริบทที่กำหนดเท่านั้น - ตัวอย่างเช่น การเก็บ development skills ให้ห่างจาก Telegram
Skills vs Memory
ทั้งสองอย่างมีความคงอยู่ข้าม session แต่มีวัตถุประสงค์ที่แตกต่างกัน:
| Skills | Memory | |
|---|---|---|
| What | Procedural knowledge - how to do things | Factual knowledge - what things are |
| When | Loaded on demand, only when relevant | Injected into every session automatically |
| Size | Can be large (hundreds of lines) | Should be compact (key facts only) |
| Cost | Zero tokens until loaded | Small but constant token cost |
| Examples | "How to deploy to Kubernetes" | "User prefers dark mode, lives in PST" |
| Who creates | You, the agent, or installed from Hub | The agent, based on conversations |
กฎง่ายๆ: ถ้าคุณจะใส่ไว้ในเอกสารอ้างอิง มันคือ skill ถ้าคุณจะแปะไว้บนโพสต์อิท มันคือ memory
Tips
ให้ skills มีความเฉพาะเจาะจง skills ที่พยายามครอบคลุม "DevOps ทั้งหมด" จะยาวเกินไปและคลุมเครือเกินไป skills ที่ครอบคลุม "การ deploy Python app ไปยัง Fly.io" นั้นเฉพาะเจาะจงพอที่จะมีประโยชน์จริง
ให้ agent สร้าง skills หลังจากทำงานหลายขั้นตอนที่ซับซ้อน Hermes มักจะเสนอให้บันทึกแนวทางนั้นเป็น skill ตอบตกลง - skills ที่สร้างโดย agent เหล่านี้จะบันทึก workflow ที่แม่นยำ รวมถึง pitfalls ที่ค้นพบระหว่างทาง
ใช้ categories จัดระเบียบ skills เป็น subdirectories (~/.hermes/skills/devops/, ~/.hermes/skills/research/, ฯลฯ) สิ่งนี้ช่วยให้รายการจัดการได้ง่ายและช่วยให้ agent ค้นหา skills ที่เกี่ยวข้องได้เร็วขึ้น
อัปเดต skills เมื่อมันล้าสมัย หากคุณใช้ skills แล้วพบปัญหาที่มันไม่ได้ครอบคลุม ให้บอก Hermes ให้อัปเดต skills ด้วยสิ่งที่คุณได้เรียนรู้ skills ที่ไม่ได้รับการดูแลจะกลายเป็นภาระ
สำหรับข้อมูลอ้างอิง skills ฉบับสมบูรณ์ - fields ของ frontmatter, conditional activation, external directories, และอื่นๆ - ดูได้ที่ Skills System.
extent analysis
TL;DR
The issue seems to be related to the configuration and usage of Hermes Agent, a conversational AI tool, specifically with its skills system, GitHub PR review feature, and voice mode, but the exact problem is unclear due to the large amount of provided context.
Guidance
- Clarify the Issue: Identify the specific problem or error encountered with Hermes Agent, such as issues with skills, GitHub PR reviews, or voice mode.
- Check Configuration: Verify that the configuration files (e.g.,
config.yaml) are correctly set up for the desired features, including skills, GitHub integration, and voice mode. - Review Documentation: Consult the official Hermes Agent documentation and guides for setting up and using skills, GitHub PR reviews, and voice mode to ensure all steps were followed correctly.
- Test Isolated Features: Test each feature (skills, GitHub PR reviews, voice mode) in isolation to identify if the issue is specific to one feature or a combination of them.
Example
Given the complexity and breadth of the provided information, a specific code example cannot be accurately provided without a clearer understanding of the issue. However, ensuring that the config.yaml file is correctly configured for the desired features is a good starting point.
Notes
- The issue description lacks a clear problem statement, making it challenging to provide a precise solution.
- Hermes Agent's features, such as skills and voice mode, require specific configurations and setups that must be correctly implemented to function as intended.
- Consulting the official Hermes Agent documentation and seeking support from the community or developers may provide more targeted assistance.
Recommendation
Apply a systematic approach to troubleshooting by isolating and testing each feature individually to pinpoint the exact cause of the issue, and then refer to the official documentation or community support for tailored solutions.
Vote matrix · Quick signals
Still need to ship something?
×6Another batch ranked right after the header list — different links, same matching logic.
TRENDING
- Feature Request: Configurable per-minute rate limiting (RPM) for models to prevent 429 errors
- Android: Hermes App + Termux install share ~/.hermes and cause silent permission loops
- hermes update emits unicode-animations ANSI demo in non-interactive logs
- hermes update downgrades aiohttp from 3.13.4 to 3.13.3
- npm install warns about deprecated @babel/plugin-proposal-private-methods
- DingTalk inbound media URLs are skipped as unreadable native image paths
- fix(dashboard): ChatPage clears header action buttons on ALL pages, not just Sessions
- [Bug]: check_web_api_key() hardcodes built-in backends — third-party web search plugins silently disabled
- Hermes Web UI 修复经验:GatewayManager 补丁、进程 D 状态、数据库升级问题
- Telegram gateway can silently drop turn after /stop with response=0 chars while internal work continues
- Bug Report: v0.14.0 上下文污染 — 历史回复碎片回注到新请求
- Bug: hermes skills search table truncates Identifier column — install fails with copied value
- [skills-index-watchdog] Skills index is stale or degraded (degraded)
- Discord approval embed not rendering on web/mobile — embed data present in API but invisible
- Idea: Discord voice-channel participation / opt-in auto-join mode
- [Feature]: Claude Code--ultrawork
- build-arm64 job deterministically fails on cold cache (Azure SAS token expires mid-build)
- [Enhancement] computer_use: action=type should fall back to key events for terminal emulators (Ghostty/Terminal.app/iTerm2)
- Feature Request: Session Recovery on Temporary Provider Outage
- [Bug]: Hermes dashboard not working on NixOS (container)
- [Feature]: Add option to ignore @all/@everyone mentions in Feishu group chats
- QQ Bot WebSocket 频繁断开:长时间工具执行阻塞 asyncio 事件循环导致心跳超时
- patch tool: new_string escape sequences (\t) get written literally
- Feature Request: i18n / 多语言支持(国际化)
- Bug: web_crawl schema lets models auto-guess "instructions" instead of asking the user via clarify
- feat: `!command` prefix for direct shell execution (like Claude Code)
- Expose currently-running cron jobs via /api/jobs (or new endpoint)
- [Bug]: Kanban parent-child handoff: scratch workspace GC destroys artifacts before child can read them
- [Bug, Windows] hermes gateway restart loses session context — planned_stop_marker not written before SIGTERM
- [Bug]: Codex→DeepSeek fallback sends assistant turns without reasoning_content → HTTP 400 (require-side cross-provider failover)
- [Bug]: Update got stuck half way, reboot it, then ModuleNotFoundError: No module named 'hermes_cli'
- Kanban dispatcher corrupt-board handling and multi-profile gateway ownership ambiguity
- Gateway can resend a short fallback message when the real final Telegram response was already delivered
- [BUG] Bedrock: Fix 'Invalid API Key format' for presigned URL tokens
- Secret redaction corrupts code syntax in tool output (write_file, execute_code, terminal)
- Unable to connect Ollama Cloud with Pro Subscription to Hermes
- feat: fuzzy substring matching for /skill autocomplete
- PRD: Autonomous market-impact prediction briefing system
- Kanban dashboard should support task/card deep links
- [Feature] Native Feishu CardKit Streaming: consolidate best-in-class implementations
- [Feature]: Inject mental model into context when using Hindsight
- Interactive CLI hides tool output despite display.tool_progress=all, and hermes chat -v does not restore it
- fix(api_server): _handle_responses drops text.format JSON schema — structured output constraints silently ignored
- state.db FTS corruption goes undetected — no integrity check, no repair path
- bug: fallback routing can select text-only models for image requests and hide the primary failure
- feat(kanban): persist worker session_id per run and pass --resume on respawn after unblock
- feat(kanban): support GitHub/OMO lifecycle bridge for Xiyou-style automation
- Expose update-safe TUI/composer hooks for voice transcript and composer events
- Hide or configure voice transcript status rows in editable dictation mode
- [Feature]: Per-Tool / Per-Toolset Approval Policies
- Context compression creates orphan sessions missing from state.db
- messaging platform
- feat: Add read-only / silent monitoring mode for WhatsApp adapter
- double-.hermes path mismatch, the HOME env var leak, and the fallback-notification UX problem
- Bug: Plattform-Bundle name `hermes-yuanbao` in `agent.disabled_toolsets` silently kills ALL tools in gateway path (Telegram + cron), CLI unaffected
- CLI /yolo (in-chat) does not bypass dangerous command approvals — env var freeze + missing enable_session_yolo call
- OpenAI Codex provider crashes with "'NoneType' object is not iterable" (HTTP None)
- DEEPSEEK_API_KEY blocked by env blocklist in gateway process — cron jobs fail with deepseek provider
- fix(feishu): Card action callback routing issues - invalid message_id and unrecognized /card command
- Discord plugin: profiles without explicit `discord:` block silently get `require_mention=true` + `auto_thread=true` (regression in cc8e5ec2a)
- [Bug]: DISCORD_ALLOWED_ROLES ignored by gateway _is_user_authorized — role-authorized users get 'Unauthorized user' rejection
- [Bug]: /new, /clear, and /reset commands freeze the terminal session
- openai-codex subscription backend returns HTTP 200 with response.output=None, causing Slack/cron failures
- RFC: Centralized Model/Provider Registry
- bug: openai-codex provider — TypeError: 'NoneType' object is not iterable on every request (gpt-5.5)
- [Feature]: Source-aware instruction gate — architectural mitigation for indirect prompt injection
- Named custom provider stale_timeout_seconds ignored because runtime provider is normalized to `custom`
- guard test (ignore)
- [Feature]: per-platform LLM request_overrides (extra_body / reasoning_effort / service_tier)
- One-shot smoke: add Flue-backed orchestration fixture
- Gateway should not treat stale Codex app-server progress as final response after post-tool silence
- `docker_run_as_host_user: true` breaks bundled skills: Hermes home is mounted into `/root/.hermes` but the container runs as a non-root user (`HOME=/home/pn`)
- [Bug]: gateway api_server streaming bypasses server-side tool-call loop when chat_template_kwargs.enable_thinking=false (model emits tool name as plain text)
- [Feature]: Pre-install python-telegram-bot in Umbrel Hermes Docker image
- YouTube Shorts filter not working in youtube-content skill
- v0.15.0 PyPI release breaks ALL platforms — plugin.yaml manifests missing from package
- RFC: On-demand tool/skill/MCP discovery — decouple schema registration from process lifecycle
- Pixshelf: local-first stock photo workflow command center
- [Bug]: baoyu infographic skill should not silently bypass image_generate
- Pixshelf v1.5: manual submission tracking for stock agencies
- `hermes config set` silently accepts unknown keys, writing them where the runtime never reads
- Honcho memory prefetch hang on fresh CLI subprocess in v0.15.0 (regression from #27190)
- [Bug] v0.15.0 Docker image: stage2-hook.sh, main-wrapper.sh missing; container_boot module removed
- Feature: Reduce cache-read token overhead for DeepSeek providers — configurable cache_ttl, skills snapshot trimming, memory compaction
- Windows: three bugs from daily use (plugin discovery, gateway exit code, Unicode decode
- holographic memory: HRR silently degrades to FTS5 when numpy is missing
- Make max_tokens configurable for aux vision calls
- Conversation compression desynchronizes session ID between agent context and gateway routing, causing silent message loss
- [Bug]: v0.15.0 Docker image:The TUI cannot be used in the dashboard.
- cron: skip_memory=True blocks fact_store/memory tools from all cron jobs
- TUI: Node.js OOM crash when agent uses browser tools repeatedly
- feat: model_profiles — per-model toolset and memory config
- Automatic background skill patching disrupts active sessions (severe impact on local models)
- ensure_hermes_home() creates root-owned dirs in profile subdirectories when kanban workers are dispatched
- Feature: opt-in webhook bypass for DISCORD_ALLOW_BOTS — allow operator-initiated probes without weakening bot-loop guard
- v0.15.0: Codex requests fail HTTP 400 when participant display_name contains non-ASCII (emoji breaks input[].name pattern)
- Architecture: State Persistence Precedence (Memory vs Skills vs Hooks)
- [Bug]: cronjob tool: create action always fails with "schedule is required for create" even when parameters are provided
- codex-oauth: 'NoneType' object is not iterable in _run_codex_stream (gpt-5.5) — every turn fails non-retryably
- Docs/Config: Plugin local scope enablement ambiguity
- [Bug]: CLI freezes after using /new command (WSL)
- Profile Codex auth can ignore global credential pool when local state is stale
- [workflow-engine] CRITICAL: variable substitution crashes on regex metachars in user input
- [workflow-engine] HIGH: loop and bash nodes leak subprocesses on timeout
- [workflow-engine] HIGH: README documents config env vars the engine never reads
- [workflow-engine] MEDIUM: workflow_run rate limit bypassable via concurrent calls (TOCTOU)
- [workflow-engine] chore: manifest gaps, side-effectful register(), dead code, unauth kanban dispatch
- [mcp_lazy] HIGH: synthetic mcp_server_<name> stub collides with a real MCP server named 'server'
- [mcp_lazy] HIGH: promote_server eager flag documented but never persisted
- [mcp_lazy] MEDIUM: _prev_mode dict leaks and goes stale; not cleared on session evict
- [mcp_lazy] MEDIUM: get_pool has unlocked check-then-set race on pool creation
- [mcp_lazy] MEDIUM: pre_tool_call gives no guidance for unpromoted server-stub calls
- [mcp_lazy] chore: undeclared pre_tool_call hook, nonexistent 'mcp_load_tools' name in docs, missing tests
- [a2a_fleet] CRITICAL: server never auto-starts — register() runs outside an event loop
- [a2a_fleet] CRITICAL: auth_required defaults to false on a cross-machine surface
- [a2a_fleet] HIGH: remove invented disable() hook — loader never calls it, port leaks on reload
- [a2a_fleet] HIGH: plugin.yaml missing kind / provides_tools / requires_env (token env undeclared)
- [a2a_fleet] MEDIUM: tighten wide-open CORS, anonymous /health peer leak, and peer-URL SSRF
- [a2a_fleet] MEDIUM: relocate tests to tests/plugins/ and cover sync-register + auth-default paths
- xai-oauth auxiliary client incorrectly uses Responses API (CodexAuxiliaryClient), causing 403 on compression/vision/web_extract
- [Bug]: Direct Copilot gpt-5.5 large resumes are killed by 12s Codex TTFB watchdog
- [Bug]: `hermes uninstall` does not work on Windows
- TUI: Thinking block leaks raw JSON and Σ character
- Hostinger VPS: migration Hermes Agent → Hermes WebUI impossible (tini + UID mismatch + sessions)
- /goal judge over-continues exploratory goals unless the assistant explicitly says the goal is complete
- /goal auto-continuation can be amplified by preflight compression/session split and resurrect stale task state
- Dashboard infinite reload loop in loopback mode — GET /api/auth/me returns 401 on every page load
- [Bug]: Provider/LLM switch leaves stale encrypted_content causing 400 errors on Telegram sessions
- [Bug]: Infinite reload loop / React state loop on Sessions tab (Firefox + Chrome) — repeated 401 on /api/auth/me (v0.15.0)
- show_reasoning should work independently of streaming in CLI mode
- Feature Request: Strip reasoning/<think> blocks from TTS preprocessing
- mcp add / mcp test raise NameError when mcp package not installed
- v0.14.0 dashboard breaks behind reverse proxies — two regressions
- Skills hub creates empty category directories when no skills installed
- [Bug]: Custom endpoint: ChatCompletions returns content, but Hermes treats response as empty (v0.14.0)
- fix: atomic_replace() fails with EXDEV when HERMES_HOME is a cross-filesystem symlink
- fix(gateway): Feishu session cancellation orphans session guard, permanently blocking messages
- Custom endpoint pricing can overestimate Crof qwen3.5-9b cost by 1,000,000x
- MCP OAuth callback: module-level port global causes port collisions and structural weaknesses vs upstream
- Bug: send_message tool bypasses validate_media_delivery_path security check
- Proposal: Add Mnemosyne to official memory provider documentation
- feat(swarm): support custom verifier/synthesizer body + skills
- Template conversion failed
- Error occurred in the operation of the agent node in the workflow.
- PubSub client overrides Sentinel client when REDIS_USE_SENTINEL is enabled
- Frontend description of the Retrieval node output does not match the actual output
- JSON type input var raise Intenal server error
- cannot extract elements from a scalar
- 负载均衡 为模型配置多组凭据,并自动调用,此功能无法选择
- add models is error
- panic: could not create filter
- Persist partially generated messages when /chat-messages/:task_id/stop is called
- MCP server connection fails with 403 — request never leaves Dify (SSRF proxy suspected)
- Support durable async execution backends for long-running workflow steps
- [Xiaomi MiMo] Credentials validation fails with 400 "Not supported model mimo-v2-flash" when using Token Plan endpoint (v0.0.7)
- After clicking preview on a parent-child segmented knowledge base, it shows 0 chunks
- Retrieval score differs between UI upload (.docx) and API upload (.txt) despite identical chunk content and embedding model
- gemini cli crash again
- Xbox gift card code damage
- Damage caused by the gemini cli crash
- ioctl(2) failed, EBADF (Bad File Descriptor)
- Feat: Support Bun as an alternative runtime/package manager for updates and extensions
- fatal error again!!!!
- ioctl error
- Critical Crash: ioctl(2) failed, EBADF in ShellExecutionService.resizePty
- ioctl(2) failed, EBADF
- v0.44.0 Regression: Critical crash with ioctl(2) failed, EBADF during PTY resize
- Crash on startup: ioctl(2) failed, EBADF in UnixTerminal.resize
- Crash: `ioctl(2) failed, EBADF` in `node-pty` during PTY resize on macOS
- Gemini CLI crashes with `ioctl(2) failed, EBADF` in `node-pty` during `resizePty`
- Remote Role
- ERROR ioctl(2) failed, EBADF /home/mich
- RangeError: Maximum call stack size exceeded
- EBADF Error during folder creationg broke session and terminal glitches
- MAIP / Gargoub Project - Mediterania - North Coast
- Gemini cli crash again in this morning
- ERROR ioctl(2) failed, EBADF
- Verified node install fails — Checksum verification failed (Cloud)
- The extended debugging key did not arrive during registration.
- CollaborationPane unmounts collaboration store on single-user instances, causing permanent "No network connection" state
- Workflow cannot be saved when the name contains "->" (Potentially malicious string)
- automation does not work and does not show an error
- Raj Ai Automation
- Default Data Loader: DOMMatrix is not defined error
- Feature: Per-node execution timestamp overlay on canvas during workflow run
- AI Agent + Vertex `gemini-3.5-flash`: 400 "missing thought_signature" on sequential multi-turn tool calls (post-#24982)
- PDF Loader in Pinecone Vector Store fails due to pdf-parse version conflict (v2 not supported)
- emailReadImap: add UID deduplication, batch size cap, and numeric uid enforcement
- Manual node execution fails with "Could not find a node" when autosave is disabled (N8N_WORKFLOWS_AUTOSAVE_DISABLED)
- Schedule Trigger stopped firing — workflow Published & active, manual executions succeed, no automated fires for 2+ hours
- [MCP SDK] create_workflow_from_code intermittently returns HTTP 500, often as a false negative (workflow persists anyway, causing duplicates on retry)
- Credential-load wedge: workflows using googleApi/jwtAuth credentials silently fail to execute after key rotation
- Google Sheets Trigger every minute is not working manual Execute is working sent email
- [BUG] Plugin marketplace MCP connector remains stuck "still connecting" when mcp-remote requires OAuth
- [redacted at user request]
- Opus 4.7 behavioral regression: loaded instruction-following discipline degraded in recent Claude Code/Cowork updates
- [BUG] Tailscale via Homebrew CLI + Mac App Store GUI, both Macs on macOS, Cowork blocked by VPN detector despite Tailscale being a mesh VPN with no traffic interception
- stopShellPty on tab switch kills active sessions (exit 143) — regression in May 27 build
- [BUG] Long URLs are broken into multiple lines and become unclickable in terminal output
- [BUG] claude rm/stop/reap SIGKILLs background session tree without SIGTERM grace, orphaning git index.lock and similar
- [BUG] Default git workflow in the system prompt was pushed without context or consent
- [MODEL] Inconsistent output quality / Ignoring instructions (overfitting and inappropriate repetition of Korean vocabulary)
- You've hit your weekly limit · resets May 31 at 5pm (Asia/Shanghai)
- Paid yearly subscription silently downgraded to Free with no user action
- [Regression v2.1.153] Plugin bash hooks fail with "echo: write error: Permission denied" on Windows (claude-mem, shell: "bash")
- [BUG] Connector toggles in conversation are not clickable — must click text label instead
- [remote-control] Input from mobile app/browser not reaching host session — output works fine
- Model fails to read/reference CLAUDE.md contents despite being loaded in context
- [BUG] Claude Desktop reinstall destroys Code chat history (transcripts + Recents) while regular Chat history, project files, and memory all survive
- Bypass mode clamps to Accept Edits even with the toggle ON (Claude Code Desktop 1.9255.2 / CC 2.1.149)
- [BUG] TUI input freezes randomly mid-typing — entire prompt becomes unresponsive for minutes
- [BUG] Cowork downloads Linux ELF binary instead of macOS binary on macOS Sonoma 14.8.7 — exit code 132 (SIGILL) on every session
- [Feature Request] Persistent project memory — sessions forget everything on close, forcing users to keep many sessions open
- [Bug] Thread context stale after sleep/resume, returns outdated date and calendar data
- [FEATURE] Add context window usage indicator and warning before auto-compaction
- [BUG] Dictation error: Invalid character in header content ["x-config-keyterms"] on Windows
- [Bug] Anthropic API Error: Server rate limiting despite normal usage
- Does delegating work to `claude -p` subprocesses reduce context accumulation in the parent session?
- [BUG] Claude Code hangs on M1 Mac when terminal says "opening browser to sign in" and browser opens
- [BUG] Claude_Preview MCP preview_start spawns dev server with main-repo cwd instead of session's worktree cwd
- [Bug] Anthropic API Error: Server rate limiting during request execution
- [Bug] Anthropic API Error: Server rate limiting on concurrent requests
- [Bug] Ultraplan ready notification fires before cloud agent completes execution
- [BUG] API 500 ERROR ALL THROUGHOUT THE DAY
- [BUG] Cowork: Live Artifacts folder path changed in 1.9255.2, no automatic migration from Documents\Claude\Artifacts
- [Bug] Auto-compact never triggers despite statusline reporting "100% context used" (v2.1.153, Max sub, 200K mode)
- [BUG] [Desktop / macOS] 'Open in → New Window' detached session: font renders smaller than main, no per-window controls, Cmd+/Cmd- keystrokes routed to main window instead
- Feature request: option to switch between classic and new minimal UI
- [Feature Request] Show timestamps for each message
- [BUG] Terminal corruption when permission prompt appears while navigating Agent Teams agent selection menu
- [FEATURE] Allow users to customize the background color of the Claude desktop app beyond the current light/dark theme presets.
- [BUG] Statusline not displaying on Windows [fixed]
- Background agent UI Stop button is a no-op for stuck agents — process keeps consuming tokens
- Background agents silently die on session pause/resume — no completion notification, no work recovery
- Add option to hide email address from welcome banner
- [BUG] SSH Remote: `projects` field in remote ~/.claude.json becomes null after desktop restart — jsonl files intact, UI shows 'No messages yet' for every session
- [Bug] Claude Code not applying fixes despite claiming to complete tasks
- billing is unfair and poorly documented
- [BUG] Claude Code on the web: declared plugins inactive on first session, require restart to fully load
- [BUG] Restore from archive deleted sessions instead of restoring them
- [BUG] M365 connector fails with AADSTS50011 in Cowork — localhost vs 127.0.0.1 redirect URI mismatch
- claude agents: workflow slash-commands missing from dispatch-input completion (regression-adjacent to #61424)
- Claude Desktop's Info.plist missing TCC usage strings, blocks all EventKit-based MCP servers
- False-positive safety blocks on self-administered governance amendments — request for owner-authority mode for verified professional users
- [BUG] Stop pushing "AUTO"-mode
- [DOCS] Plugin marketplace guide omits `skipLfs` option for git-based sources
- [DOCS] MCP docs omit combined startup notification for MCP server and connector authentication
- [DOCS] Agent view docs omit macOS Privacy & Security identity for background agents
- [DOCS] Npm update docs do not explain release-channel behavior for `claude update`
- [DOCS] Agent SDK docs omit `subagent_type: "claude"` worktree and output persistence behavior
- [DOCS] Background session docs omit `$CLAUDE_JOB_DIR` temp-file behavior
- [FR] mask env-var values in 'claude mcp get <server>' output
- [FR] subagent worktrees should not inherit stale local 'user.email' from prior dispatches
- [BUG] Windows: Grep tool leaks rg.exe + conhost.exe processes (~2000 zombies / 14 GB RAM in long sessions)
- [BUG] Stats dashboard "Peak hour" appears off by one hour
- [BUG] Diff highlight (teal SGR background) bleeds past changed text in 2.1.150–2.1.153
- [FEATURE] confirm before deleting session
- Plugin PostToolUse hooks still silently skip in Claude Desktop / Cowork (re-filing closed #51904)
- /code-review skill: silent fallback to main...HEAD reviews other people's commits, and JSON-only output is hard to read
- Monitor tool doesn't source the shell snapshot like Bash does; PATH-dependent tools (jq, sleep, etc.) fail in Monitor commands on macOS/Nix
- [Bug] Long input lines truncated with ellipsis while typing instead of wrapping in terminal UI
- [FEATURE] VS Code extension: Render submitted user messages as Markdown in chat
- OSC 52 copy from Claude TUI doesn't reach clipboard inside tmux (regression in 2.1.146–2.1.153)
- [BUG] RemoteTrigger create/update returns HTTP 400 with circular error: "event_type is required" / "unknown field event_type"
- [BUG] Option to hide or minimize the built-in "status footer" (multi-line debug/cost panel) [re-raise of #31475]
- [Bug] Feedback submissions being closed without review or action
- [FEATURE] Word-jump cursor navigation in Chat input (option+arrow / bindable actions)
- [FEATURE] ! shell mode: filesystem tab completion
- [BUG] API Error: Usage credits required for 1M context
- claude agents: OSC 52 clipboard emission broken in tmux (regression in 2.1.146–2.1.153)
- CLI crashes on macOS 15 M3 - exit code 1
- [FEATURE] Support Cmd+V image paste from clipboard
- [FEATURE] Enhance claude.ai M365 connector to support MS Planner
- [BUG] Slash command autocomplete hijacks pasted absolute file paths starting with /
- PreToolUse hook `if` filter false-positives on complex Bash commands
- [BUG] Diff panel hangs/whites out
- Feature Request: Support drag-and-drop for binary documents (.wps, .doc, .docx, .xlsx, .pdf) in VS Code extension
- [BUG] activation of 1M context in VSCode
- [FEATURE] Support i18n / language localization for built-in slash command outputs
- Ctrl+V para colar imagens deixou de funcionar no CLI (Windows, PowerShell)
- [FEATURE] Please add Norwegian (Bokmål/Nynorsk) language support to the Claude Code interface
- [BUG] OTel log events (claude_code.user_prompt, api_request_body, tool_decision, hook_execution_complete) emitted with empty trace_id/span_id while sibling spans correlate correctly
- [BUG] Cowork crashes on every message, no VM logs generated, missing AppData\Roaming\Claude
- [FEATURE] first-class session handoff + per-session token budgets for unattended runs
- [FEATURE] Smart paste: convert clipboard code to file reference chips (like Cursor)
- [Feature Request] Restore chat pin functionality to title chat submenu
- [BUG] SIGILL issues with version 2.1.153
- [BUG] Cowork plugin upload fails with generic "Plugin validation failed" when a `description` field in any SKILL.md frontmatter contains angle brackets (`<…>`)
- [BUG] Desktop App 2.1.144+: startup scanner deletes cliSessionId from claude-code-sessions local files on every launch — session not found on disk
- [Feature Request] Add keyboard shortcut to copy last message with proper formatting
- [MODEL] Opus 4.7 not 1M
- Allow naming/renaming background agents in `claude agents` view
- Stale worktrees in .claude/worktrees/ are never cleaned up, consuming massive disk space
- Agent worktrees are never cleaned up, silently consuming disk space
- Subagent worktrees not auto-cleaned when reviewer writes scratch files
- [Bug] Skill initialization hangs for extended duration in Plan Mode
- Claude Desktop writes malformed registry Run entry (nested escaped quotes) - crashes Windows Task Manager and other Run-key parsers
- IME candidate window shows at bottom-right corner instead of caret position (Windows CMD)
- [BUG] Pressing 'Escape' doesn't close the /BTW conversation when the main conversation is asking for approval
- [BUG] Opus 4.7 (1M) intermittently emits empty-string values for tool_use.input fields, killing the session
- FleetView agent UI shows "running" with incrementing elapsed time after agent has returned
- /doctor flags context-scoped cmd+c binding as macOS conflict (false positive)
- [BUG] Text Rendering in Elvish
- Desktop app: Bypass Permissions mode flips to Accept Edits on first prompt (M5 / macOS 26.5)
- [Workaround] Date-Weekday Verification Hook — Prevents Claude from writing wrong weekdays
- [BUG] Claude Code create c:/memfs directory without asking me.
- [BUG] Claude Code's Bash execution waits forever with no processes running
- [BUG] usage stays stuck waiting for 5 hr limit after upgrading to premium seat in team plan
- [Workflow tool] resume cache is unreachable for nontrivial workflows because LLM dispatchers can't transcribe args byte-exactly
- Code review (Preview): "Add a repository" shows no results for private GitHub org repos
- [BUG] /context commands blows up context
- [Feature Request] Add precache expiry hook to enable proactive compaction before token eviction
- [BUG] Context indicator shows 0% at session start despite ~20K+ tokens already loaded
- [Feature Request] Add semantic search for --resume session history
- [Feature Request] Add session search, tagging, and filtering capabilities
- [BUG] Cowork Dispatch reports "desktop not available" on Windows 11 while standard Cowork works normally
- [Bug] Claude Code provides incorrect suggestions with high confidence despite errors
- defaultMode: acceptEdits silently overrides per-path permissions.ask rules for Write/Edit
- [FEATUR configurable tip interval (e.g. tipIntervalSeconds: 30 in settings)E]
- Plugin marketplace fails to load: schema rejects 'displayName' key (v2.1.153)
- claude agents: in-session copy uses broken OSC 52 path while overview correctly uses tmux buffer
- [BUG] Plugin agent descriptions (and custom agents) load unconditionally into context — no parity with disable-model-invocation for skills
- Crashed ultrareview consumed a free credit despite producing zero findings
- [Bug] Character rendering issue - invisible or missing text display
- [BUG] Cowork: processo Claude Code encerra com código 3 — .claude.json não contém token de autenticação (Windows 11 25H2)
- [BUG] 2.1.153 silently discards tools/list response from rmcp 0.12.0 HTTP MCP server (works in 2.1.152, wire-identical handshake)
- VS Code extension: option to auto-resume last session when reopening a workspace folder
- [Bug] Conversation continuation failure
- [BUG] Cowork crashes every time I start a new chat or attempt to continue an existing one in any project. The error displayed is: "Claude Code è andato in crash
- [Bug] Unannounced quota changes
- Native update/install fails with 'socket connection was closed unexpectedly' behind proxy — undici TLS incompatibility
- [BUG] Session name reverting after manual change
- [BUG] 非正常思考,上下文过长时,一直显示思考,点击interrupt按钮失效
- Honor `tools:` frontmatter when an agent is invoked via `@mention` — strip `Task` only when the agent did not declare it
- macOS TCC popup still recurring on v2.1.153 — "2.1.153" would like to access data from other apps
- Claude Code leaks pty handles — exhausts pseudo-terminals on macOS after long session
- [Bug] Agent fails to execute or respond to user input
- [BUG] Persistent "Expecting value: line 1 column 1 (char 0)" JSON parse error after tool execution
- [Feature Request] Implement proactive unit test coverage recommendations for recurring bugs
- VS Code panel lacks status line + terminal lacks image paste in Codespaces, forcing a tradeoff
- `/powerup` only shows ~10 lessons — allow viewing the full catalog
- [Bug] Context contamination after auto-compact with unrelated email draft of Tejo/Sado Basin
- [Bug] VSCode terminal output displays corrupted text with garbled symbols
- [Feature Request] Add LaTeX/KaTeX math rendering to TUI
- [Bug] Sub-agent PR review results not validated by orchestrating agent
- Subagents on Pro 1M tier: trivial probes pass, real workloads fail at first tool call (probe-vs-workload divergence)
- Path-scoped rules and subdirectory CLAUDE.md not loaded when creating new files matching the pattern
- AskUserQuestion: cancelling during extended thinking poisons the whole session with 400 'thinking blocks cannot be modified' (2.1.153); concurrent prompts overwrite each other
- Ideas Missing from Claude Cowork Menu (Windows)
- [BUG_BOUNTY_SAFE_POC_2026] Prompt Injection RCE Test - Command Execution Proof
- [BUG] Cowork scheduled task: execution history row not showing after successful run
- Resuming an extended-thinking session fails permanently with 400 "thinking blocks cannot be modified" (transcript stores thinking text as empty but keeps signature)
- [Bug] Plugin-registered CwdChanged and FileChanged hooks don't fire (settings.json works) — v2.1.153
- Auto-archive on PR merge / branch delete — clarify autoArchiveSessions semantics or add dedicated opt-out
- `claude mcp add` echoes Authorization header value verbatim to stdout, leaks bearer tokens to terminal and session transcripts
- [BUG] Bug report — /insights skill, Claude Code The /insights skill outputs a malformed file path.
- Plugin slash commands render with '*'-inline format instead of two-column, despite matching official plugin shape
- [Bug] Unexpected long text generation without user input or goal
- [Bug] Thinking blocks causing task progression blocked without user modification
- [BUG] (Critical!) contamination by an unknown session simirlar to the report => [Bug] Context contamination after auto-compact with unrelated email draft of Tejo/Sado Basin #63137
- [Critical] Opus 4.7 Korean output degeneration — Korean grammar itself collapses in long contexts
- [BUG] Title: Autocompact buffer persists across /clear — wastes tokens for irrelevant old context
- [Bug] Auto-Compact loses user input before processing in conversation history
- Feature: per-invocation effort parameter + runtime session-config introspection for skills
- Auto-mode classifier mislabels Azure DevOps vote -5 as "Reject" when denying PR vote actions
- [BUG] Claude Desktop and Claude Code CLI never re-register MCP tools after OAuth 2.1 handshake on a remote HTTP server
- [BUG] Workspace file tags leak across sessions
- [BUG] Ink renderer crashes on Windows 11 build 26200 (Canary) duplicate banners, terminal mode leaks, mid-operation aborts
- [BUG] Claude Code Desktop issue
- PTY master fd leak in Claude desktop app exhausts macOS kern.tty.ptmx_max after ~2-3 days
- [BUG] Claude Code — Session Management after Unexpected Interruption
- [Windows] Cowork OpenTelemetry exporter does not initialize - zero events emitted to any destination, including loopback
- [Bug] Opus 4.7: 400 `thinking blocks ... cannot be modified` on long extended-thinking sessions, triggered by history-altering events (scheduled prompts / parallel tool-call cancellation)
- [BUG] API Error: Server is temporarily limiting requests (not your usage limit) · Rate limited
- Multi-plugin custom marketplace: only first plugin registered in installed_plugins.json, skills don't load
- [BUG] Git push through the SDK's git proxy fan-outs into ~500 GitHub REST API calls, exhausting the 5,000/hour budget after a handful of pushes
- [BUG] Claude took liberties it really shouldn't with my global config
- [BUG] Agent window focus lost after navigating with arrow keys, causing scroll deadlock
- [BUG] `--model` flag silently ignored in interactive sessions (works in `--print` only)
- [BUG] Dispatch permanently shows "desktop appears offline" on Windows 11 - never worked on first use
- feat: support per-command enableWeakerNetworkIsolation as safer alternative to dangerouslyDisableSandbox
- /code-review outputs a raw JSON array instead of readable findings
- [BUG] Cowork — Additional allowed domains ignored on Team plan; same domain works on Pro plan
- Haiku
- [Bug] False positive blocking beneficial outcomes in tool execution
- 3P Bedrock SSO: credentials silently expire without triggering re-auth on day 2+
- CLAUDE_AUTOCOMPACT_PCT_OVERRIDE in settings.json env block silently ignored by autocompact logic
- Auto-compaction deletes main session JSONL before verifying summary completion, causing data loss
- [Bug] Claude Code not executing stated actions or producing expected results
- [FEATURE] Deferred Messages — Queue Input for End of Turn
- [BUG] Up/Down arrows in input box navigate history instead of moving cursor — regression in 2.1.149+
- Cancelling a parallel tool-call batch corrupts thinking blocks -> 400 "thinking blocks cannot be modified" permanently wedges the session
- Claude Code caused data loss, then contradicted itself about recovery (two incidents, one session)
- [Bug] Unclear error messages from Claude Code CLI
- [Bug] Agent tool rejecting due to context size limit exceeded
- claude agents: daemon and bg-spare processes spin at ~100% CPU when idle
- [BUG] Compaction fails with "context window limit" error even when context usage is low (e.g., 20%) — regression in v2.1.153
- Remote Control entitlement lost after May 27-28 incident — `Error: Remote Control is not yet enabled for your account` on active Max subscription
- PreToolUse hook exit code 2 does not block Write tool
- [Bug] Thinking blocks in latest assistant message are immutable
- GUI: dispatch file:// and custom-scheme clicks to OS shell handler
- Show current model in statusLine by default
- [Bug] Agent console becomes unresponsive to keyboard input after multiple agents initialized
- [FEATURE] PreToolUse hooks should have a way of updating the environment
- [Bug] Unable to start or use Claude Code CLI
- [BUG] Repository not visible in Claude Code web repo picker
- Session permanently wedged on 400 "thinking blocks cannot be modified" after parallel tool_results
- [Bug] @ autocomplete loses sibling repos after a file edit in multi-repo workspace
- Unclear error message when creating sub-agent without authentication
- [Bug] Anthropic API errors causing frequent failures and high token usage
- [BUG] @ mention file picker only shows packages, not individual files (desktop app - Code tab)
- [Bug] TUI panel footer remains sticky and consumes excessive terminal space
- PR-status polling exhausts GitHub GraphQL rate limit on repos with many open PRs
- [BUG] Windows: welcome panel not shown in some project folders (2.1.153)
- [Bug] Anthropic API Error: thinking blocks corrupted during context compaction with extended thinking enabled
- API 400 "thinking blocks cannot be modified" permanently bricks session during agent activation (interleaved thinking + tool use)
- Right-click Copy copies the whole message instead of the selection; pasted text retains dark background
- Mid-session model switch corrupts conversation when extended thinking is enabled (API 400: 'thinking blocks cannot be modified')
- [BUG] Markdown file links in chat output do not open files when clicked (VS Code extension)
- Stuck retry loop: `400 thinking blocks cannot be modified` on large interleaved-thinking turns using AskUserQuestion
- [FEATURE] Prompt user for approval before auto-compaction proceeds
- Custom MCP connectors not attachable to scheduled routines — no UUID discovery path
- [BUG] Claude in Chrome — Navigation blocked for teams.cloud.microsoft and outlook.cloud.microsoft after Microsoft domain migration**
- [BUG] Claude Desktop — Personal plugins panel renders list but is entirely non-interactive (macOS, v1.9255.2)
- [Bug] error when using Workflows
- [BUG] Persistent "update available" notification despite being on latest version
- [BUG] Sweep Agent from /code-review never completes
- [Bug] Tool calls not executing or returning results
- [FEATURE] Cloud-synced memory and settings across machines
- [Bug] Terminal UI freezes when Ctrl+O view exits during interactive prompt in plan mode
- Continuous api errors when using claude code with Opus 4.7 with thinking on low
- [Feature Request] Add support for installing and using previous Claude Code versions
- [Bug] Extended Thinking: Summarized thinking blocks fail signature validation when resent to API
- [Bug] Anthropic API Error: 'thinking' blocks cannot be modified
- [Bug] Anthropic API Error: Thinking blocks cannot be modified with extended thinking mode
- Feature request: Lazy/on-demand MCP server connections
- [Bug] Tool Arguments Parsed as String Instead of Object
- [Bug] Anthropic API Error: Insufficient context provided
- [Bug] Claude Opus occasionally uses moskovian(russian) orthography instead of Ukrainian in system-prompted responses
- Opus 4.8: backgrounded task completions (subagents AND Bash) crash with 400 "thinking blocks cannot be modified"
- [Bug] Opus 4.7 fabricates stable preferences ("my default") to rationalize arbitrary choices when challenged
- [Bug] Unable to update Claude Code CLI
- [BUG] Desktop app: /remote-control mints link + connects bridge (main.log) but in-chat link/QR panel never renders
- Feature: sessionColor and sessionName in .claude/settings.json
- [BUG] Anthropic API error: thinking blocks
- [FEATURE] Support Remote MCPs in Cowork as in Claude Code
- [Bug] Anthropic API Error: 400 Bad Request with Redacted Thinking - 0 4.7 & 4.8
- [Bug] Anthropic API Error: Cannot modify thinking blocks from different model versions
- Interleaved thinking + multi-tool turn corrupts thinking block (text blanked, signature kept) → permanent 400 'blocks must remain as they were'
- [BUG] Mode/permission changes mid-tool-loop (effortLevel: xhigh) poisons entire session
- Session failure log: Opus 4.6 ignores its own rules for an entire session
- [BUG] "400 Guardrail was enabled" error when using Claude Opus 4.8 with AWS Bedrock
- [Feature Request] Add subagent approach selection option to avoid accidental feedback
- Persistent 400 'thinking blocks in the latest assistant message cannot be modified' — interleaved thinking persisted with empty text + signature bricks sessions
- [BUG] DesktopvsApp
- [BUG] Opus 4.7 cache hit rate collapse after May 27 incident — Messages 1.1k→88.9k in 9 minutes, $630/session
- [Bug] Anthropic API Error: Invalid thinking block format
- [BUG] FUCK CLAUDE
- Opus 4.8 extended thinking: Stop hook block re-entry corrupts thinking blocks → 400
- [Bug] 4.8 Fails when accessing previous model history
- [Bug] Unintended File Modifications During Execution
- [DOCS] Model configuration docs omit lean system prompt default scope and model exceptions
- Add "Always allow globally" option to permission prompts
- Server-side model upgrade (Opus 4.7→4.8) wedges in-flight sessions with `thinking blocks cannot be modified` 400
- [DOCS] AskUserQuestion docs missing multiple-choice prompt decision threshold
- [DOCS] Agent view docs omit shell-command background session launch syntax
- [DOCS] Agent view dispatch input docs incorrectly imply `/logout` dispatches as a prompt
- [DOCS] Claude in Chrome docs omit connected-browser selection behavior
- [DOCS] Plugin docs omit `defaultEnabled: false` for opt-in plugins
- Feature Request: Customizable chat text colors for user and assistant messages
- [DOCS] `/plugin` Discover tab docs omit directory-based suggested plugin pins
- VSCode Chrome integration silently fails: 3 distinct bugs
- [DOCS] MCP stdio docs omit session environment variables
- [Bug] Anthropic API error on second request within session with Claude Opus 4.8
- Cowork emits a blank session "index" handoff on focus when a CLI session is paused awaiting input
- [DOCS] MCP docs omit `claude mcp list/get` pending-approval output for unapproved project servers
- [BUG] /compact fails with 400 error when last assistant turn contains thinking blocks
- [DOCS] `/claude-api` docs omit Opus 4.8 migration guidance
- [DOCS] Fast mode docs still recommend deprecated Opus 4.6 override variable
- [DOCS] Bash tool docs omit `$TMPDIR` consistency across sandboxed and unsandboxed commands
- [Bug] Anthropic API Error: 400 Bad Request on Extended Thinking
- [DOCS] Background session docs omit worktree-isolation behavior for spawned subagents
- Built-in mechanistic self-verification of verifiable claims (symmetric to the auto permission gate)
- [DOCS] Worktree docs do not clarify `worktree.baseRef: "head"` inside linked worktrees
- [BUG] Excessive RAM usage with multiple parallel chats (~10 sessions → 30 GB memory pressure, macOS OOM)
- [DOCS] Managed MCP policy docs omit invalid `allowedMcpServers`/`deniedMcpServers` entry behavior
- [DOCS] Effort docs omit `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` unsupported-model behavior
- Regression (2.1.147–2.1.150?): resuming an extended-thinking session after a CC update/model-switch → unrecoverable 400, session bricked
- [DOCS] Windows updater docs omit `claude.exe` in-use recovery guidance
- [DOCS] VS Code auto mode docs still tie mode-picker visibility to bypass-permissions setting
- [DOCS] MCP docs omit `/mcp` tool list and detail rendering behavior
- [DOCS] Fine-grained tool streaming docs still describe provider opt-in behavior
- bypassPermissions: session startup reads flat pref, GUI toggle writes per-account pref — they never sync
- [BUG] Claude Desktop Code tab causes disk write limit violation — 8.5GB in 11 min, macOS kills app (M5, v1.9659.1)
- Ultrareview v2.1.96: docs describe /tasks command + claude ultrareview --json subcommand that don't exist; findings hard to read after completion
- I'd be happy to help create a GitHub issue title, but I don't see the error message in your message. Could you please share the specific error you're encountering? That way I can generate an accurate and descriptive issue title for you.
- [BUG] Claude in Chrome `file_upload` rejects all scheduled-task sessions with misleading error (real cause: INVALID_SESSION)
- Extended thinking: signed thinking block 'cannot be modified' (400) permanently wedges session
- RTL text support for Hebrew (and Arabic) in Claude Code
- [Bug] Random errors occurring across multiple operations