All shelves / Mods / Workflow
repoql
By RepoQL
repoql is a Claude Code workflow mod by RepoQL.
Indexes a repo through the RepoQL host so Claude can search its structure, and draws whether that host is ready or working.
Draws
Install
The marketplace name is repoql-plugins.
/plugin marketplace add RepoQL/RepoQL /plugin install repoql@repoql-plugins
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 1.7.11
- License
- MIT
- Repo stars
- 11
- Last change
- 2026-10-12
What it can reach
- Draws in the session
- Reaches the network or an outside service
- Sees tool calls
- Calls another program on this machine
The plugin starts its MCP server through a launcher that looks for rql in its install directory, ~/.local/bin on macOS and Linux, so it does not depend on PATH. If rql is not there yet, the launcher runs the standard hosted installer. The binary is about 180 MB, and the download runs detached, so closing the session does not abort it. The plugin never keeps a private copy. Set REPOQL_NO_BOOTSTRAP=1 to skip that download. The README then gives a manual install. This page does not copy that command. The install log is ~/.local/state/repoql/bootstrap.log. The README does not say how to delete that log. In a new session, a prompt you send meanwhile waits behind the SessionStart hook until the download finishes, for up to 200 seconds. Needs rql 1.7.13 or later for the live display. An older one shows only the resting state. On the desktop, a small rql badge sits above the prompt, and Details opens a pane that says whether RepoQL is ready, working, or not running. In the terminal, a dim label in the prompt footer names the state, and the same work is one line above the prompt. The display reads rql monitor and never starts a host. A RepoQL call that has run for ten seconds names itself beside the spinner. Before a write or edit, invariants for that file are added as extra context, once per session. After a read, known terms are defined once per session. Turn the display off with the plugin's Show RepoQL host state option. The import tool can pull an external repo into the graph through the host.
The marketplace name is repoql-plugins. The same marketplace also lists repoql-uplink. The display is one part of the plugin. The rest is MCP tools, skills, and an agent named dora that drives RepoQL in its own context. Adding context before a write is not a hold.
Demo

What it hooks into
session.startWhen a session startssession.attachA Claude Code eventtool.callAround a tool call, where it can hold oneui.renderDraws into the sessionSessionModeSpinnerAbovePromptPane
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Hooks 5
PreToolUse · Write|Edit|MultiEdit. "${CLAUDE_PLUGIN_ROOT}/scripts/concepts-write-hook.cmd"SessionStart · startup|resume|clear|compact. "${CLAUDE_PLUGIN_ROOT}/scripts/session-start.cmd"PostToolUse · ^(Read|read_file|mcp__.*[Rr][Ee][Pp][Oo][Qq][Ll].*__read)$. "${CLAUDE_PLUGIN_ROOT}/scripts/vocabulary-read-hook.cmd"PostToolUse · ^(Write|Edit|MultiEdit|NotebookEdit)$. "${CLAUDE_PLUGIN_ROOT}/scripts/worktree-track-hook.cmd"PostToolUse · ^mcp__(.*[Rr][Ee][Pp][Oo][Qq][Ll].*|rql)__.*$. "${CLAUDE_PLUGIN_ROOT}/scripts/worktree-check-hook.cmd"
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- RepoQL
- Category
- Workflow
- Marketplace
- repoql-plugins
- Repo
- RepoQL/RepoQL
- Folder
- plugins/repoql
- Version
- 1.7.11
- License
- MIT
- Repo stars
- 11
- Last change
- 2026-10-12
- Language
- TypeScript
- Files
- 62