Engraph

What it does

When your agent uses it

• Users need to search knowledge bases
• Find connections between documents
• Discover related content via link graphs
• Query indexed markdown collections

Example prompts

• “/engraph”

Requirements

• Compatibility (from SKILL.md): Requires engraph CLI. Install via `brew install devwhodevs/tap/engraph` or from GitHub releases.
• Pre-approved tools (allowed-tools): Bash(engraph:*), mcp__engraph__*

What it can do on your machine

Read from SKILL.md and the folder at commit f9a95bc. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(engraph:*)
  • mcp__engraph__*

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Requires engraph CLI. Install via `brew install devwhodevs/tap/engraph` or from GitHub releases.

  From compatibility in the SKILL.md frontmatter.

Context cost

Engraph loads about 792 tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 157 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~65

When it runs · the whole SKILL.md, loaded when a task matches

~792

With references · SKILL.md plus every file in references/, read only if the agent opens them

~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from devwhodevs/engraph at commit f9a95bc, republished under its MIT licence (© devwhodevs). 157 words, ~792 tokens.

name

engraph

description

Index and search document collections using hybrid semantic + graph + full-text search. Use when users need to search knowledge bases, find connections between documents, discover related content via link graphs, or query indexed markdown collections.

allowed-tools

Bash(engraph:*), mcp__engraph__*

compatibility

Requires engraph CLI. Install via `brew install devwhodevs/tap/engraph` or from GitHub releases.

license

MIT

metadata.author

jsynowiec

metadata.version

1.0.0

engraph index /path/to/documents        # Incremental; only changed files re-embedded
engraph index /path/to/documents --rebuild
engraph status                          # File count, stats, index freshness
engraph clear                           # Drop the index (--all also removes models)

engraph search "how does the auth flow work"
engraph search "performance regressions last month" --explain
engraph search "architecture decisions" -n 5 --json

engraph graph show "path/to/note.md"    # Connections for a document
engraph graph show "#docid"             # By document ID
engraph graph stats                     # Nodes, edges, density

engraph context topic "authentication" --budget 8000
engraph context who "Person Name"
engraph context project "Project Name"
engraph context vault-map                 # Collection structure overview
engraph context read "path/to/note.md"    # Full content + metadata
engraph context list --tags architecture  # Filter by tags, folder, created_by, etc.

engraph index /path/to/documents
engraph search "your query"

© devwhodevs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/engraph of devwhodevs/engraph.

• SKILL.md
• references/http-rest-api.md
• references/mcp-setup.md

Open the folder on GitHubat commit f9a95bc