nbsvision 0.23.0

One CLI. Every Sense. Zero Tokens.

Synesthesia

DOM/code/pixel → compact tree. One CLI that turns web pages, code, and screenshots into small searchable trees.

pip install nbsvision
syn --help
syn dom --url https://github.com --mini

🇬🇧 English | 🇷🇺 Русский | 🇩🇪 Deutsch | 🤖 AI

Requires Python 3.11+. From source: pip install git+https://github.com/freundapps/NBSvision.git

36 tools · two-circuit @✓ · 0⏋ LLM — «One CLI. Every Sense. Zero Tokens.»

---

What is this?

NBSvision is a command-line toolkit (syn) that compresses messy inputs — live web pages, PDFs, spreadsheets, screenshots — into compact structural trees. Instead of feeding raw HTML or huge JSON to an LLM, you get a small tree you can search locally with syn find, using zero tokens for navigation and inspection.

Why would I use it?

1. Understand any web page in the terminal

Turn a live URL into a readable layout tree:

syn dom --url https://github.com --mini
syn dom --url https://github.com --json > tree.json

2. Find elements without an LLM

Search a saved tree by tag, name, or class — no API calls:

syn find tree.json --tag button
syn find tree.json --name "Sign in"

3. Turn files or screenshots into structure

Decode office documents or capture the screen:

syn decode data.xlsx --mini
syn pixel --screenshot --to-nbs

What's next?

Run interactive onboarding — it asks what you have (HTML, PDF, screenshot, code) and suggests the right commands:

syn doctor

For deeper topics: syn explain format, syn explain verify, or syn --help.

Terminology

ULTRA, NBSX, codon, and other format names are documented in docs/glossary.md. You do not need them for the quickstart above.

---

More commands

Task	Command
Verify a spec	syn verify < spec/two-circuit-verify.nbs
Scrape page text	syn grab --url URL --text
Run a workflow	syn run recipes/elif-to-dict-dispatch.nbsx
List all tools	syn --help

Full signatures and agent-oriented docs: README.ai.md · machine-readable: README.ai.ultra

---

Real-world examples

Site	Command
github.com	syn dom --url https://github.com --mini
google.com	syn dom --url https://google.com --mini
apple.com	syn dom --url https://apple.com --mini

---

Project layout

NBSvision/
├── README.md              # This file — for humans
├── README.ai.ultra        # Compact tree — for LLM agents
├── recipes/               # 8 NBSX refactoring templates
├── spec/                  # NBS spec, verification fixtures
└── scripts/               # Python modules (syn router)

---

License

MIT — use freely, attribution appreciated.

⭐ If this saved you time, star the repo.