Vectis
Enhanced Debug Console for VS Code — Filter, search, and navigate debug logs with ease.
Features
- Log Level Filtering — Toggle TRACE, DEBUG, INFO, WARN, ERROR with one click
- Smart Log Parsing — Automatically detects JSON, logfmt, and traditional formats
- Text Search — Filter logs with regex support
- Line Wrapping — Toggle between wrap and truncate modes
- Source Navigation — Click source locations to jump to code
- Session Aware — Automatically switches context with debug sessions
- Auto-scroll — Follows new logs, pauses when you scroll up
Installation
From Marketplace
Search for "Vectis" in VS Code Extensions.
From Source
git clone https://github.com/molaga/vectis
cd vectis
npm install
npm run compile
Then press F5 to launch the Extension Development Host.
Usage
- Start any debug session (F5)
- The Vectis panel appears in the bottom panel (alongside Output, Terminal, Debug Console)
- Use filter buttons to show/hide log levels
- Use the search box to filter by text
- Click source locations to navigate to code
- Double-click a log entry to copy it
Vectis automatically detects and parses these formats:
JSON (Zerolog, Zap, slog)
{"level":"error","msg":"Connection failed","time":"2025-01-28T08:53:59Z"}
{"severity":"WARNING","message":"Retry attempt"}
Logfmt (Logrus, slog TextHandler)
level=error msg="failed to connect" duration=5.2s
time="2025-01-28T09:18:25+02:00" level=info msg="Request completed"
[MyApp] 2025/01/28 00:42:38 WARN: Connection timeout
08:53:41 INF server/handler.go:135 > request processed
Configuration
| Setting |
Default |
Description |
vectis.defaultFilters |
["info", "warning", "error"] |
Log levels shown by default |
vectis.maxLogsPerSession |
10000 |
Maximum logs per session |
vectis.wrapLines |
true |
Wrap long lines (false = truncate) |
vectis.autoFocus |
true |
Focus panel when debug starts |
vectis.jsonLevelFields |
["level", "severity", "lvl"] |
JSON fields for log level |
vectis.jsonMessageFields |
["msg", "message", "text"] |
JSON fields for message |
Commands
| Command |
Description |
Vectis: Clear Logs |
Clear logs for current session |
Vectis: Toggle Line Wrap |
Switch between wrap/truncate |
Vectis: Focus Vectis Panel |
Focus the Vectis panel |
Development
# Install dependencies
npm install
# Watch mode (rebuilds on changes)
npm run watch
# Production build
npm run package
# Type checking
npm run typecheck
# Linting
npm run lint
Contributing
Issues and PRs welcome at GitHub.
License
MIT — see LICENSE
