SynapseNexus Extension

SynapseNexus provides a VS Code dashboard for architecture analysis, review, and agent workflow delivery.

Folder layout

Path	Purpose
`src/`	VS Code extension host — Compass service, sidecar bridge, command handlers
`compass-ui/`	React webview apps — see compass-ui/README.md
`agents/`	Bundled default agent personas (planner, reviewer, implementer, synthesizer)
`workflows/`	Default workflow YAML templates for the Flow builder
`skills/`	Bundled skill markdown templates
`tools/`	Bundled workflow tools (e.g. MarkItDown document converter)
`media/`	Built webview assets (Compass UI output lands in `media/compass/`)
`vendor/python/`	Bundled Python libs for Graphify and MarkItDown (offline VSIX)

Highlights

Compass sidebar for task context and workspace navigation
Graphify code maps with Ollama or cloud LLM backends
Review tab with Ollama generation and skill-augmented prompts
Flow tab: agent bank, workflows, and MarkItDown document.convert tool steps
Templates tab: skills library (markdown with YAML frontmatter)
Rust sidecar for fast local data processing

Requirements

VS Code ^1.85.0
macOS Apple Silicon release: no system Python required (embedded CPython 3.12 in the VSIX)
Ollama (optional, for local LLM extraction)

macOS release build (offline Graphify + MarkItDown)

On macOS arm64, from this folder:

pnpm install
pnpm run build:mac

This downloads embedded Python 3.12, vendors all wheels (including tree-sitter) into vendor/python/, and packages a darwin-arm64 VSIX (~150–200 MB). No PyPI access is needed on the target machine.

Local development (F5)

# once per machine (from repo root or extension/)
pnpm run build:mac

Then from the repository root:

./scripts/dev-prepare.sh

Open VS Code and press F5. Reload the Extension Development Host after rebuilding.

Settings

Setting	Description
`synapse.python.path`	Override Python executable (default: embedded `python-runtime` when present)
`synapse.graphify.backend`	`ollama` or `auto`
`synapse.graphify.ollamaModel`	Ollama model for Graphify extraction
`synapse.ollama.apiKey`	API key for Ollama Cloud models

License

MIT

Wegolu Synapse Nexus

Amir-wegolu-nexsus