Tracepanel

Command line

The tracepanel command that @tracepanel/js installs, to run a command with Tracepanel on, run the agent and serve your traces over MCP.

@tracepanel/js installs the tracepanel command. Run it with npx from your project's directory, so it finds the project's store.

CommandWhat it does
tracepanel run <command>Runs a command with Tracepanel on.
tracepanel devRuns the agent in the foreground and serves the console.
tracepanel mcpRuns an MCP server for AI coding agents.

tracepanel run

npx tracepanel run node server.js

tracepanel run starts the command with --import @tracepanel/js/register added to NODE_OPTIONS, and with TRACEPANEL_ENABLED=1. Use it in a package.json script, so the app starts with Tracepanel and no flag:

{ "scripts": { "dev": "tracepanel run node server.js" } }

tracepanel dev

npx tracepanel dev [--port 8765]

tracepanel dev runs the agent in the foreground, with the console on http://127.0.0.1:8765/. Use it to watch the agent's output, or to read the traces after your app has stopped. --port moves the console.

tracepanel mcp

npx tracepanel mcp [--values]

tracepanel mcp runs the agent's MCP server on stdin and stdout, for Claude Code, Cursor and other coding agents. --values adds SQL parameters and local variables to its answers. See AI coding agents.

On this page