NetStacks for VS Code
Browse NetBox inventory and open rich SSH/Telnet terminal sessions to your network devices, all from VS Code.
This extension embeds the same netstacks-agent sidecar as the NetStacks Terminal desktop app, and shares its data directory by default — so saved sessions, folders, NetBox sources, and credential vault carry over.
Features
- NetBox inventory tree with lazy device loading
- Saved sessions tree with folder hierarchy
- SSH and Telnet sessions in editor-tab webviews powered by xterm.js (WebGL renderer, search, web links)
- Credential vault with master-password unlock gate
- One-click connect to any NetBox device
Requirements
- VS Code 1.120 or newer.
- If you already use NetStacks Terminal, the extension shares its data directory — no extra setup. Otherwise the first run creates a fresh database and prompts you to set a vault master password.
Settings
| Setting |
Default |
Description |
netstacks.dataDir |
"" |
Override data directory (empty = shared NetStacks dir). |
netstacks.agentPort |
0 |
Pin a fixed agent port (0 = ephemeral). |
netstacks.terminalTheme |
dark |
xterm theme name. |
netstacks.reconnectDelay |
3000 |
Initial reconnect backoff (ms). |
netstacks.scrollback |
10000 |
Terminal scrollback. |
netstacks.fontSize |
0 |
Terminal font size (0 = follow editor). |
netstacks.fontFamily |
"" |
Terminal font family (empty = follow editor). |
Commands
NetStacks: … — Unlock Vault, Lock Vault, Set Master Password, Open Session…, New Session…, New Folder…, Add NetBox Source…, Sync NetBox Source…, Restart Agent, Show Agent Logs, Reconnect All Sessions, MCP Setup…
MCP Server Integration
NetStacks includes a Model Context Protocol (MCP) server that exposes all extension tools to external AI clients like Claude Code, Cursor, and Continue. This enables AI assistants to interact with your network infrastructure directly.
Setup for Claude Code (macOS)
- Run the command NetStacks: MCP Setup… from the Command Palette
- Click Copy Claude Code Config in the setup panel
- Add the copied JSON to
~/Library/Application Support/Claude/claude_desktop_config.json
- Restart Claude Code
The MCP server provides 17 tools including session management, NetBox queries, SNMP operations, DNS/WHOIS/ASN lookups, and contextual information about your active terminal session.
Setup for Cursor
- Run NetStacks: MCP Setup…
- Click Copy Cursor Config
- Add to
.cursor/mcp.json in your workspace
- Restart Cursor
Disable MCP Integration
Set netstacks.mcp.enabled to false if you don't want to use MCP integration. This prevents the extension from writing handoff files for external clients.
