All shelves / Mods / Workflow
navigator
By qf-studio
navigator is a Claude Code workflow mod by qf-studio.
Draws a /nav pane of context, cost, reads, and the next task step as a button, and a phase band above the prompt, and guards fan-out reads.
DrawsHolds a command
Install
The marketplace name is navigator-marketplace.
/plugin install navigator --marketplace qf-studio/navigatorIt 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
- 8.4.11
- License
- MIT
- Repo stars
- 354
- Last change
- 2026-10-20
What it can reach
- Draws in the session
- Reads usage or context figures
- Holds a command
- Sees tool calls
- Runs a command when you press
- Reaches the network or an outside service
Navigator is a Claude Code plugin for context engineering. It loads documentation when it is needed instead of upfront. The one-step install needs Claude Code 2.1.275 or later. On older versions, add the marketplace first with /plugin marketplace add qf-studio/navigator, then /plugin install navigator. Restart Claude Code after installing. The runtime and the /nav pane need 2.1.287 or newer, and older versions run the same behaviors through the Python fallback, without the pane. Say Initialize Navigator in this project once, then Start my Navigator session in each session. The runtime gates task-shaped prompts, guards fan-out reads, records what each turn finished, and writes one line to a reject log every time it says no. /nav opens a pane beside the session. Its cards show the context fill and whether this is a good moment to compact, today's cost, tokens, and cache hit rate, the fan-out verdict and today's reject count, what the typed judge decided about your last prompt, the current leg of the active task as a button that submits it, and memories for the open task, which you can pin into your next prompt. A one-line band above the prompt shows the phase, context fill, and next action. The typed prompt judge is off by default because the prompt text is sent to the API. With a TypeSafe key it makes one request per prompt, and enable judge turns it on. An optional language-server plugin lets the research agent answer symbol questions with go-to-definition and references instead of text search.
The plugin is the repository. The marketplace name is navigator-marketplace. Most of Navigator is skills that start from plain language, and the runtime with the pane, the band, and the gates is the mod. The /nav pane is why this page files it under workflow. where-am-i draws four things above the prompt: the goal, what is happening now, what is waiting on you, and the next step. ctx-handoff hands a long session off to a fresh conversation when the window fills. This one gates prompts and reads by its own rules, and draws its task legs and context advice in a pane. In the source, the Read refusal comes from the same rules the Python hooks used. An update check asks GitHub for the latest release, once an hour by default.
Demo

What it hooks into
session.startWhen a session startsclassic.SessionStartA Claude Code eventclassic.PreCompactA Claude Code eventclassic.PostCompactA Claude Code eventclassic.SubagentStartA Claude Code eventclassic.ConfigChangeA Claude Code eventclassic.SetupA Claude Code eventcommand.runWhen you run its slash command/navtool.callAround a tool call, where it can hold oneReadBashclassic.TaskCreatedA Claude Code eventclassic.TaskCompletedA Claude Code eventclassic.PostToolUseFailureA Claude Code eventclassic.StopA Claude Code eventprompt.submitWhen you send a promptturn.completeWhen a turn endsui.renderDraws into the sessionAbovePromptPane
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/navOpen the Navigator pane
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- qf-studio
- Category
- Workflow
- Marketplace
- navigator-marketplace
- Version
- 8.4.11
- License
- MIT
- Repo stars
- 354
- Last change
- 2026-10-20
- Language
- Python
- Files
- 904