Wanderer
« Not all those who wander are lost... »
J.R.R. Tolkien
Wanderer is a VS Code extension for spatial code navigation on an infinite canvas. Open files as draggable editors, move around freely, zoom and de-zoom as needed and follow definitions or project usages without losing context.
This project is in early development, expect bugs and rough edges until v1 is released. Feedback and contributions are very welcome!
Notice: As I am working simultaneously on a lot of projects, things here may seem to move slowly but they are still in progress. I'm always monitoring my notifications and messages, so if you have any questions or want to chat about anything, feel free to reach out!
Inspired by Haystack.
Feature overview
- Spatial canvas with drag-to-move nodes, minimap, viewport controls, zoom, and pan.
- Fast opening of files from a path-first picker with recent-file ranking.
- Definition and usage navigation with Cmd/Ctrl-click inside editors.
- Canvas following user custom theme.
- Copilot integration with inline completions and inline chat. You must allow the extension to sync with Copilot in order to use these features.
Quick start
Prerequisites
Installation
Launch VS Code Quick Open (⌘+P), paste the following command, and press enter.
ext install jean.wanderer
Or install this theme from the extension panel : search for "Wanderer".
You can find this extension in the Visual Studio Code Marketplace.
Run locally
npm install
npm run build
- Press F5 in VS Code (Extension Development Host).
- Run
Wanderer: Open Canvas from the command palette.
- Add files with
Wanderer: Open Current File on Canvas or the canvas toolbar.
- Cmd/Ctrl-click symbols to traverse definitions or project usages.
If the panel shows the fallback page, rebuild first with npm run build.
Development
npm install
npm run build
Watch mode:
npm run watch:webview
npm run watch:extension
Type checking:
npm run typecheck
Code Quality
npm run format
npm run format:check
npm run lint
npm run lint:fix
npm run knip
npm run knip:strict
Notice
This extension's logo is a simple reproduction of the Gandalf's glyph left on the door of Bag End in The Hobbit, it is absolutely not an original creation of mine.
