Studio
Launch ExpressoTS Studio, the local developer experience platform, from your project root.
expressots studio [options]
What it does
- If
@expressots/studiois not a devDependency, the CLI installs it as one using your project's package manager (detected from the lockfile). - Spawns
node_modules/.bin/expressots-studio startwith the forwarded options. - Studio's UI opens in your browser (unless
--no-browseris set).
Options
| Flag | Alias | Default | Description |
|---|---|---|---|
--port | -p | 3333 | UI port. |
--agent-port | -a | 3334 | Agent WebSocket port. Must match EXPRESSOTS_STUDIO_PORT if set. |
--src | ./src | Source directory to scan. | |
--no-browser | false | Don't open the browser automatically. |
Examples
# Default ports, opens browser
expressots studio
# Custom ports, no browser (e.g. inside a remote dev container)
expressots studio --port 4000 --agent-port 4001 --no-browser
# Different source folder
expressots studio --src ./apps/api/src
Prerequisites
- Studio activates only in development. Make sure
NODE_ENVisdevelopmentor unset. @expressots/studio-agentmust be installed as a devDependency of your app. If it's missing, the agent never starts and you'll see an empty UI. See Studio Installation for the full activation rules.
See also
- Studio Overview: what Studio is, what it shows, and the built-in security analysis.
- Studio Installation: env flags, activation, troubleshooting.