ClaudeCodeMod

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.

In Claude Code
/plugin install navigator --marketplace qf-studio/navigator
Open the repo

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
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

The See Where You Are section of the Navigator README: the runtime that gates prompts and guards fan-out reads, and the author's picture of the /nav pane with the context, session, reads, judge, and next cards.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • classic.SessionStartA Claude Code event
  • classic.PreCompactA Claude Code event
  • classic.PostCompactA Claude Code event
  • classic.SubagentStartA Claude Code event
  • classic.ConfigChangeA Claude Code event
  • classic.SetupA Claude Code event
  • command.runWhen you run its slash command/nav
  • tool.callAround a tool call, where it can hold oneReadBash
  • classic.TaskCreatedA Claude Code event
  • classic.TaskCompletedA Claude Code event
  • classic.PostToolUseFailureA Claude Code event
  • classic.StopA Claude Code event
  • prompt.submitWhen you send a prompt
  • turn.completeWhen a turn ends
  • ui.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
Repo
qf-studio/navigator
Version
8.4.11
License
MIT
Repo stars
354
Last change
2026-10-20
Language
Python
Files
904

Same repo on other shelves

Marketplaces

  1. 227alekspetrov/navigatorqf-studio/navigatorFinish What You Start — Context engineering for Claude Code. Sessions last 20+ exchanges instead of crashing at 7.356

Other mods in Workflow

aftermidudevQueues prompts with /after while Claude works, draws the queue above the prompt, and sends the next one as your message when the turn ends.narratormidudevSpeaks a one or two sentence recap after each turn, in your language, with your system's best free voice, switched from the footer or /narrator.cc10xromiluz13For cc10x, which writes every workflow to disk, draws the phase, running agent, and next step above the prompt, and a pane of the whole step chain.engineerswingermanHolds a commandFor DAE, a spec- and test-driven methodology kit, draws a pipeline band and a /dae pane, and denies unconfirmed pushes and a frontier model on a loop.jevmem-paneAvinash-jetwaniFor jevmem, memory saved to JEVMEM.md, draws a side pane of what it recalled for your prompt, its guard's last call, and what it saved.vbwswt-labsHolds a commandFor VBW, which proves every requirement with a check, draws a Mission Control pane and a Comms strip, and denies risky commands during a run.project-sentinelArjun0014Holds a commandDraws a status bar above the prompt for long runs, with milestones, context, cache, and the 5-hour window, a Control Room panel, and asks before risky calls.cortexesXBlueSkyFor Cortexes, a vault of your recorded sessions, draws its session-start menu as a band above the prompt, and offers a hand-off once the context is 70% full.proof9frankbriaHolds a commandTurns a bug into a CodeFRAME requirement and checks the ledger before each git commit Claude makes, warning by default or denying in block mode.directorEvolvingAgentsLabsHolds a commandKeeps a team's way of working as linked statements Claude plans from, and draws a status line and a band to run a waiting plan or accept a lesson it learned.bigquery-agent-analytics-modGoogleCloudPlatformStreams each session's prompts, model requests, tool calls, and subagents as rows to your BigQuery table, and says above the prompt when they land.next-stepsbradtraversyAfter each turn, has Haiku suggest two or three next prompts above the prompt, as buttons on the desktop that draft one, or 1, 2, and 3 in the terminal.
All 396 in Workflow