Skip to content

regrevia/Envoy / integrations/skills/envoy

envoy

Flagged

Read material the host cannot get itself: video or audio transcripts and frames, PDFs and Office documents, image posts, pages that need scrolling, cookies, or login, GitHub repo/tree/blob/commit/pull/issue links when no gh or git is available, articles a plain fetch truncates, and reads that must stay retained so a later turn can expand, search, or replay them. Start with a plain host fetch; call Envoy only after it is blocked, truncated, or renders an empty shell, or when the answer must outlive the turn. Do not call Envoy for a short static page a plain fetch already answers, for an article whose body a plain fetch already returned in full, for GitHub, GitLab, or Bitbucket source navigation or a repo README while gh or git is available (use gh api, git show, or plain fetch), for material already in this turn's context (use envoy_expand or envoy_search on its material_id), or for a link the user only wants edited, quoted, or saved.

FileKindSize
INSTALL.mdmarkdown12.5 KB
LICENSEother11.1 KB
NOTICEother433 B
SKILL.mdskill md54.3 KB
hosts/README.mdmarkdown2.8 KB
hosts/mcp.jsonconfig111 B
references/protocol.mdmarkdown10.3 KB
test-prompts.jsonconfig7.9 KB

hosts/README.md

View on GitHub
# Envoy Host Setup

See [`../INSTALL.md`](../INSTALL.md) for GitHub Skill and runtime installation.
The bundled MCP configuration assumes the `envoy` command is available on
`PATH`:

```json
{
  "mcpServers": {
    "envoy": {
      "command": "envoy",
      "args": ["mcp"]
    }
  }
}
```

`mcp` with no flag declares the four link tools (read, expand, search, and
visual observation) because `core` is the default. Export
`ENVOY_MCP_TOOLSET=full` before the host starts the bridge, or pass
`--toolset full`, to expose local-video, profile discovery, collection,
replay, visual-history, and doctor tools. The toolset is fixed for the life
of the MCP process.

## Link-first hooks

Envoy also ships host hooks that tell the model to try `envoy_read` before a
native web fetch whenever a user prompt contains a public URL. The shared policy
lives in `envoy hook prompt`; the host packages only wrap it. Claude Code loads
plugin hooks directly, DSH uses `agent/pre-step`, and Codex 0.156+ requires the
user-level install shown below because it no longer loads plugin-supplied
lifecycle hooks.

| Host | Install | Hook mechanism |
| --- | --- | --- |
| Claude Code | `claude plugin marketplace add regrevia/Envoy` then `claude plugin install envoy@envoy` | plugin `UserPromptSubmit` |
| Codex | `codex plugin marketplace add https://github.com/regrevia/Envoy.git`, `codex plugin add envoy@envoy`, then `envoy hook install --host codex` | user-level `~/.codex/hooks.json` `UserPromptSubmit` |
| DeepSeek Harness | install `integrations/dsh/envoy-dsh` as a bundle | Cordis `agent/pre-step` |

Inspect the hook without a host:

```bash
printf '%s' '{"prompt":"读一下 https://example.org/"}' | \
  envoy hook prompt --host codex
```

The hook ignores localhost/private URLs, honours an explicit “不要用 Envoy” /
“do not use envoy” opt-out, and fails open when Envoy is missing. Set
`ENVOY_BIN` to an absolute path if the host does not inherit your shell `PATH`.
The plugin does not hard-deny native web tools because interactive sign-in and
anti-bot challenges need a documented fallback.

After installing or updating Envoy, verify the runtime:

```bash
envoy browser setup
envoy doctor --json
envoy cache status   # local storage footprint; `envoy cache prune --dry-run` shows what it would reclaim
```

The host configuration contains no API keys, cookies, browser paths, or model
configuration. The host is responsible for declaring image input capability in
an `envoy_read` request only when it can inspect URI image resources. Envoy's
own isolated Chromium profile is local to the CLI; it does not use or import
the host's browser profile. Public pages run headlessly, and a visible Envoy
window opens only when user login or verification is required. The browser
profile is private to the OS account (POSIX mode `0700`; Windows inherits the
user's home-directory ACL).
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall