# KnoSky

Local GPS for AI assistants in code and doc folders.

## Install

```bash
npx knosky@latest .
```

Requires Node.js 20+. Runs on your machine. No account.

## In the package

- Local map / indexer of your project
- City HTML view for people
- MCP server (map tools + optional checked route tools)
- Mode A (tips) and Mode B (checked yes/no)
- Packs: Claude Code, Cursor, Codex, Hermes
- doctor health check · early multi-helper coordination (L3)
- Optional PR navigation tips (never blocks builds by default)
- Docs on knosky.wiki and GitHub

## Not included

- A coding model or IDE replacement
- A cloud vault of your source by default
- A promise that multi-AI work is finished and risk-free everywhere

## Sites

- Product: https://www.knosky.com/
- Docs: https://knosky.wiki/
- GitHub: https://github.com/SathiaAI/knosky
- Install: https://www.knosky.com/install.html
- What’s in the box: https://www.knosky.com/#package

## Proof note

Our own small test: about 68% fewer tokens, 70% fewer tool calls, about 6× faster to the right file (guided vs wandering). One internal study — not a guarantee for every project.

## Honesty

Public claims should stay at or below what `npx knosky@latest doctor` shows on that install. L3 multi-helper support is early scaffolding.

## Enterprise path (optional)
- enterprise/regulated profile: security report, audit pack/verify, architecture intel
- private synthetic adversarial gauntlet (not public by default; not customer data)
- map tools read-only; Mode B separate; doctor honesty ceilings
- install: npx knosky@latest enterprise . --no-serve