Installation

npm install -D @expressots/studio

Quick Start

CLI Usage

# Start Studio
npx expressots-studio start

# With options
npx expressots-studio start --port 3333 --agent-port 3334

# Show project info
npx expressots-studio info

# Clean Studio data
npx expressots-studio clean

Programmatic Usage

import { Studio } from "@expressots/studio";

const studio = new Studio({
  uiPort: 3333,
  agentPort: 3334,
  dbPath: ".studio/studio.db",
  srcPath: "./src",
});

await studio.start();

// Studio is now running
// UI: http://localhost:3333
// Agent: ws://localhost:3334

// To stop
await studio.stop();

Integration with ExpressoTS CLI

# Via ExpressoTS CLI (when integrated)
expressots studio

CLI Commands

start (default)

Start ExpressoTS Studio.

Options:

• -p, --port <port> - UI port (default: 3333)
• -a, --agent-port <port> - Agent WebSocket port (default: 3334)
• -d, --db-path <path> - Database path (default: .studio/studio.db)
• --src <path> - Source directory to scan (default: ./src)
• --no-browser - Don't open browser automatically

info

Show information about the current project including discovered routes.

Options:

• --src <path> - Source directory to scan (default: ./src)

clean

Remove all Studio data (database, cache).

Options:

• -d, --db-path <path> - Database path (default: .studio/studio.db)

Configuration

You can also configure Studio via expressots.config.ts:

// expressots.config.ts
export default {
  studio: {
    uiPort: 3333,
    agentPort: 3334,
    dbPath: ".studio/studio.db",
  },
};

Architecture

┌─────────────────────────────────────────────────────────┐
│  ExpressoTS Studio                                       │
│  ┌─────────────┐  ┌──────────────┐  ┌────────────┐     │
│  │   Web UI    │  │ Studio Agent │  │ MCP Server │     │
│  │ :3333       │←→│ :3334        │←→│ (AI tools) │     │
│  └─────────────┘  └──────────────┘  └────────────┘     │
│         ↓              ↓                                 │
│  Your ExpressoTS App (instrumented)                     │
└─────────────────────────────────────────────────────────┘

What's Included

• Studio Agent: Instrumentation, route discovery, request recording
• Web UI: Dashboard with trace visualization, architecture map, metrics
• MCP Server: AI-powered code generation tools (optional)

License

MIT © ExpressoTS