Finish What You Start Sessions that last. AI that learns. Features that ship.
$ npx -y skills add alekspetrov/navigator --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Repo: alekspetrov/navigator
What's inside
Finish What You Start
Sessions that last. AI that learns. Features that ship.
Navigator is a Claude Code plugin that implements context engineering for AI-assisted development.
Instead of loading all your documentation upfront (and crashing at exchange 7), Navigator loads what you need, when you need itβkeeping 94% of your context window available for actual work.
For developers using Claude Code who want sessions that finish features instead of crash mid-way.
You know the pattern:
Exchange 5: Claude forgets your recent changes
Exchange 7: Hallucinations start ("that function doesn't exist")
Exchange 8: "Context limit reached"
Restart. Reload. Re-explain everything. Repeat.
You loaded 150k tokens of documentation "just in case."
You used 8k.
The rest? Noise drowning out signal.
Navigator implements context engineeringβload what you need, when you need it.
| Metric | Without Navigator | With Navigator |
|---|---|---|
| Tokens loaded | 150,000 | 12,000 |
| Session length | 5-7 exchanges | 20+ exchanges |
| Context at end | 95% (crashed) | 35% (comfortable) |
| Token savings | β | 92% |
Result: Sessions that actually finish what they start.
Navigator v5.0 adds Theory of MindβClaude learns you.
nav-profile: Remembers your preferences across sessions
"Remember I prefer concise explanations"
β Applied in future sessions
β Auto-learns from corrections
nav-diagnose: Catches collaboration drift
Same correction twice β Quality check triggered
"You're not getting this" β Re-anchoring prompt
Loop Mode (v5.1): Run until done
"Run until done: add user authentication"
β Structured completion with progress tracking
β Dual-condition exit (heuristics + explicit signal)
β Stagnation detection prevents infinite loops
Knowledge Graph (v6.0): Project memory that persists
"What do we know about auth?"
β Unified search across tasks, SOPs, system docs
β Experiential memory: patterns, pitfalls, decisions
β Auto-surfaces relevant context on session start
Navigator is a superset. Everything you'd expect, plus context engineering.
| Feature | Navigator | Others |
|---|---|---|
| Structured workflows | β Full skill suite | β |
| Component generation | β | β |
| Test generation | β | β |
| Session longevity | 20+ exchanges | 5-7 exchanges |
| Token savings | 92% verified | None |
| Code simplification | β | β |
| Task Mode | β | β |
| Theory of Mind | β | β |
| Knowledge Graph | β | β |
| Loop mode | β | β |
| OpenTelemetry metrics | β | β |
| Figma MCP integration | β | β |
Same foundation. Superior context management.
Not estimates. Verified via OpenTelemetry.
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β NAVIGATOR EFFICIENCY REPORT β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
π TOKEN USAGE
ββββββββββββββββββββββββββββββββββββββββββββββββββββ
Your project documentation: 150,000 tokens
Loaded this session: 12,000 tokens
Tokens saved: 138,000 tokens (92% β)
π SESSION METRICS
ββββββββββββββββββββββββββββββββββββββββββββββββββββ
Context usage: 35% (excellent)
Efficiency score: 94/100 (excellent)
Check yours: Run /nav:stats after installing.
# Claude Code plugin marketplace
/plugin marketplace add alekspetrov/navigator
/plugin install navigator
# Restart Claude Code
"Initialize Navigator in this project"
"Start my Navigator session"
That's it. Navigator handles the rest.
Skills that auto-invoke on natural language:
"Start my Navigator session" β Session with 92% savings
"Create a React component for profile" β Component + tests + styles
"Add an API endpoint for posts" β Endpoint + validation + tests
"Create context marker: checkpoint" β 97% context compression
"Run until done: add dark mode" β Loop mode completion
No commands to memorize. Skills detect intent and execute.
Your sessions crash because context management is broken by default.
Navigator fixes this with context engineeringβthe same principles Anthropic recommends.
92% token savings. 20+ exchange sessions. Verified metrics.
/plugin marketplace add alekspetrov/navigator
/plugin install navigator
Finish what you start.
Skill loads but prints docs instead of executing
/plugin update navigator
Then retry. Outdated plugin version.
MIT License - See LICENSE
.agent/
.nav-config.json
design-system/
figma-mcp-integration-report.md
implementation-summary.md
mcp-sdk-summary.md
DEVELOPMENT-README.md
examples/
5-MIN-DESIGN-REVIEW.md
FEATURE-IN-3-STEPS.md
ZERO-CONTEXT-RESTART.md
grafana/
dashboard-screenshot.jpg
docker-compose.yml
grafana-dashboards.yml
grafana-datasource.yml
navigator-dashboard.json
prometheus.yml
README.md
knowledge/
concepts/
.gitkeep
graph.json
memories/
decisions/
.gitkeep
mem-002.md
mem-007.md
mem-023.md
mem-025.md
mem-039.md
mem-040.md
mem-041.md
mem-042.md
mem-043.md
resolved/
mem-038.md
mem-044.md
mem-045.md
mem-046.md
mem-047.md
mem-048.md
mem-049.md
learnings/
.gitkeep
mem-008.md
mem-010.md
mem-029.md
mem-031.md
patterns/
.gitkeep
mem-006.md
mem-017.md
mem-021.md
mem-022.md
mem-024.md
mem-026.md
mem-027.md
mem-028.md
mem-030.md
pitfalls/
.gitkeep
mem-001.md
mem-003.md
mem-004.md
mem-005.md
mem-009.md
mem-011.md
mem-012.md
mem-013.md
mem-014.md
mem-015.md
mem-016.md
mem-018.md
mem-019.md
mem-020.md
mem-032.md
mem-033.md
mem-034.md
mem-035.md
mem-036.md
mem-037.md
learning/
CONTEXT-BUDGETS.md
examples/
TRY-THIS-AGENT-SEARCH.md
TRY-THIS-LAZY-LOADING.md
TRY-THIS-MARKERS.md
frameworks/
AGENT-VS-MANUAL.md
PREPROCESSING-DECISION-TREE.md
WHEN-TO-COMPACT.md
PREPROCESSING-VS-LLM.md
PROGRESSIVE-REFINEMENT.md
TOKEN-OPTIMIZATION.md
markers/
2025-01-20-grafana-dashboard-fixes.md
onboarding/
.completed
.progress-data.json
MY-WORKFLOW.md
PROGRESS.md
philosophy/
ANTI-PATTERNS.md
CONTEXT-EFFICIENCY.md
NEXTJS-PATTERNS.md
PATTERNS.md
sops/
debugging/
.gitkeep
grafana-dashboard-empty-data.md
knowledge-graph-memory-corruption.md
test-failures.md
deployment/
.gitkeep
plugin-release.md
development/
.gitkeep
autonomous-completion.md
multi-claude-orchestration.md
multi-claude-troubleshooting.md
release-workflow.md
integrations/
.gitkeep
opentelemetry-setup.md
pilot-handoff.md
testing/
visual-regression-setup.md
system/
plugin-patterns.md
project-architecture.md
tasks/
.gitkeep
archive/
TASK-01-session-start-pm-integration.md
TASK-02-readme-markers-v1.4.0.md
TASK-03-markers-management-auto-resume.md
TASK-04-version-sync-release-process.md
TASK-05-autonomous-completion.md
TASK-06-session-statistics.md
TASK-07-skills-migration.md
TASK-08-skills-enhancements-v2.1.md
TASK-09-migration-system.md
TASK-10-project-skills-v2.2.md
TASK-11-project-skills-generation-v2.3.md
TASK-12-v3.0-skills-only.md
TASK-13-otel-session-statistics.md
TASK-14-claude-md-updater.md
TASK-14-documentation-consolidation.md
TASK-16-product-design-skill.md
TASK-17-visual-regression-skill.md
TASK-18-CORRECTIONS.md
TASK-18-PITCH.md
TASK-18-principle-to-product-v3.5.md
TASK-18-README.md
TASK-18-VERIFICATION.md
TASK-18-VISUAL-SUMMARY.md
TASK-19-multi-claude-agentic-workflow.md
TASK-19-multi-claude-workflow-learnings.md
task-22-simple-console-logger-1761948433-plan.md
task-22-simple-console-logger-1761948433-review-report.md
TASK-22-simple-console-logger.md
TASK-26-plugin-optimization-roadmap.md
TASK-27-interactive-onboarding.md
TASK-29-tom-v5-release.md
TASK-30-task-verification-enhancement.md
TASK-31-code-simplification-integration.md
TASK-32-auto-update-project-sync.md
TASK-33-workflow-enforcement.md
TASK-34-evaluate-native-task-integration.md
TASK-36-multi-agent-production.md
TASK-38-hook-migration-roadmap-v6.11.md
TASK-40-phase-3-hook-migration-v6.12.md
TASK-41-hook-silent-fail-postmortem-v6.15.1.md
poc-1769186747-evaluation-report.md
poc-1769186747-plan.md
poc-1769187675-plan.md
poc-1769187675-review-report.md
poc-1769187675-tests.py
TASK-05-landing-page-content.md
TASK-13-web-documentation-site.md
TASK-15-marketing-community-adoption.md
TASK-25-fix-multi-claude-reliability.md
TASK-35-project-memory.md
TASK-37-nav-simplify-complexity-cost-scoring.md
TASK-39-nextjs-workshop-prep.md
TASK-42-audit-remediation-roadmap.md
TASK-43-ci-gate.md
TASK-44-version-tooling.md
TASK-45-hook-tests.md
TASK-46-hook-safety.md
TASK-47-kg-integrity.md
TASK-48-detection-precision.md
TASK-49-plugin-paths.md
TASK-50-skill-templates.md
TASK-51-python-misc.md
TASK-52-docs-config.md
TASK-53-claude-plugin-root-env-var.md
TASK-54-nav-pilot-dispatch-skill.md
TASK-55-landing-docs-site.md
TASK-56-nav-brief.md
TASK-57-v7-hook-channel-spike.md
TASK-58-harness-conformance-suite.md
TASK-59-nav-hook-lib.md
TASK-60-nav-dispatch-runtime.md
TASK-61-port-hooks-to-ops.md
TASK-62-v7-new-capabilities.md
TASK-63-v7-config-docs-migration.md
TASK-64-v7-release-gate.md
TASK-example.md
tickets/
TASK-18.1-philosophy-documentation.md
TASK-18.2-narrative-rewrite.md
TASK-18.3-metrics-enhancement.md
VIDEO-PRODUCTION-PLAN.md
.claude/
.claude-plugin/
marketplace.json
plugin.json
README.md
settings.json
skills/
test-marker.md
.github/
workflows/
release.yml
test.yml
.gitignore
agents/
navigator-research.md
task-planner.md
CHANGELOG.md
CLAUDE.md
CONTRIBUTING.md
docs/
ARCHITECTURE-DIAGRAMS.md
ARCHITECTURE.md
CONFIGURATION.md
DEPLOYMENT.md
GRAFANA-DASHBOARD.md
landing-page-draft.md
MIGRATION.md
PERFORMANCE.md
PITCH.md
QUICK-START.md
upgrades/
UPGRADE-GUIDE-v3.3.0.md
UPGRADE-v3.4.0.md
UPGRADE-v4.0.0.md
VERSION-CHECK.md
examples/
nextjs-saas/
.agent/
.nav-config.json
DEVELOPMENT-README.md
sops/
development/
adding-protected-routes.md
integrations/
stripe-webhooks.md
system/
project-architecture.md
tasks/
TASK-01-auth-setup.md
TASK-04-stripe-integration.md
.gitignore
CLAUDE.md
README.md
stack-choices.md
SUMMARY.md
version-note.md
hooks/
nav_brief.py
nav_post_compact.py
nav_pre_compact.py
nav_profile_sync.py
nav_read_guard.py
nav_session_start.py
nav_task_graph_sync.py
nav_workflow_state.py
test_compact_roundtrip.py
test_hooks_smoke.py
test_nav_brief.py
test_nav_pre_compact.py
test_nav_read_guard.py
test_nav_session_start.py
test_workflow_enforcer.py
workflow_enforcer.py
jest.config.js
Makefile
README.md
releases/
RELEASE-NOTES-v3.1.0.md
RELEASE-NOTES-v3.2.0.md
RELEASE-NOTES-v3.3.0.md
RELEASE-NOTES-v3.3.1.md
RELEASE-NOTES-v3.4.0.md
RELEASE-NOTES-v4.0.0.md
RELEASE-NOTES-v4.3.0.md
RELEASE-NOTES-v4.3.1.md
RELEASE-NOTES-v4.5.0.md
RELEASE-NOTES-v4.6.0.md
RELEASE-NOTES-v4.7.0.md
RELEASE-NOTES-v5.1.0.md
RELEASE-NOTES-v5.2.0.md
RELEASE-NOTES-v5.3.0.md
RELEASE-NOTES-v5.4.0.md
RELEASE-NOTES-v5.5.0.md
RELEASE-NOTES-v5.6.0.md
RELEASE-NOTES-v5.7.0.md
RELEASE-NOTES-v6.1.0.md
RELEASE-NOTES-v6.10.0.md
RELEASE-NOTES-v6.10.1.md
RELEASE-NOTES-v6.10.2.md
RELEASE-NOTES-v6.10.3.md
RELEASE-NOTES-v6.11.0.md
RELEASE-NOTES-v6.11.1.md
RELEASE-NOTES-v6.11.2.md
RELEASE-NOTES-v6.12.0.md
RELEASE-NOTES-v6.12.1.md
RELEASE-NOTES-v6.13.0.md
RELEASE-NOTES-v6.14.0.md
RELEASE-NOTES-v6.15.0.md
RELEASE-NOTES-v6.15.1.md
RELEASE-NOTES-v6.15.2.md
RELEASE-NOTES-v6.15.3.md
RELEASE-NOTES-v6.15.4.md
RELEASE-NOTES-v6.15.5.md
RELEASE-NOTES-v6.15.6.md
RELEASE-NOTES-v6.15.7.md
RELEASE-NOTES-v6.16.0.md
RELEASE-NOTES-v6.17.0.md
RELEASE-NOTES-v6.17.1.md
RELEASE-NOTES-v6.18.0.md
RELEASE-NOTES-v6.18.1.md
RELEASE-NOTES-v6.3.0.md
RELEASE-NOTES-v6.4.0.md
RELEASE-NOTES-v6.5.0.md
RELEASE-NOTES-v6.6.0.md
RELEASE-NOTES-v6.7.0.md
RELEASE-NOTES-v6.8.0.md
RELEASE-NOTES-v6.9.0.md
UPDATE-NOTES-v4.7.0.md
UPDATE-NOTES-v5.0.0.md
scripts/
bump-version.sh
check-version.sh
install-multi-claude.sh
migrate-config.sh
multi-claude-dashboard.sh
navigator-multi-claude-poc.sh
navigator-multi-claude.sh
POC-LEARNINGS.md
post-install.sh
resume-workflow.sh
session-stats.sh
simple-poc.sh
sub-claude-monitor.sh
test-json.sh
SECURITY.md
skills/
skills-local/
social-media-post/
functions/
post_analyzer.py
SKILL.md
backend-endpoint/
examples/
users-get.ts
users-post.ts
functions/
endpoint_generator.py
route_validator.py
validation_generator.py
SKILL.md
templates/
endpoint-test-template.spec.ts
express-route-template.ts
nextjs-route-dynamic-template.ts
nextjs-route-template.ts
backend-test/
SKILL.md
database-migration/
SKILL.md
frontend-component/
examples/
Button.tsx
SearchBar.tsx
functions/
component_generator.py
file_generator.py
name_validator.py
props_interface_generator.py
style_generator.py
SKILL.md
templates/
component-simple-template.tsx
nextjs-client-component-template.tsx
nextjs-layout-template.tsx
nextjs-page-template.tsx
... 260 moreFAQ
navigator is a Claude Code plugin with 31 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes backend-endpoint, backend-test, database-migration. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.