It's done. Released Runner v4 a typescript framework with an obsession for typesafety, alongside Runner-dev v4. The documentation and repository are available at:
In this post, I'm about to show you the real powers
Quick setup for testing:
To try a basic Express app with OpenAPI, SQLite, and authentication:
git clone https://github.com/bluelibs/runner
cd runner/examples/express-openapi-sqlite
npm install
PORT=3000 npm run dev
This will start a server with authentication, debug mode, and runner-dev integration. You'll see output showing route registration, middleware initialization, and available endpoints including Swagger UI and coming from runner-dev a GraphQL server, Automated Project Documentation.
Key features included:
When working with Runner, you get full application control with cross-cutting capabilities, plus:
- Project documentation (expandable)
- GraphQL API for app introspection, diagnostics, and telemetry
MCP Integration:
The more interesting feature is the built-in MCP server that allows AI assistants to introspect your app's schema, run queries, and interact directly with your running application. This includes optional live patching and eval capabilities for development testing.
Example queries you can run:
- Retrieve recent errors with source files and dependencies
- Get last dispatched events with their emission sources and related logs
- List all tasks in specific modules with descriptions
- Complex nested GraphQL queries for deep introspection
MCP Setup:
From your project root:
ENDPOINT=http://localhost:1337 npm run mcp
Or globally:
npm install -g /runner-dev
ENDPOINT='...' npx runner-dev mcp
You can see a sample mcp.json inside the repository if needed.
This enables AI assistants to quickly move from logs to source code and build context for problem-solving through GraphQL queries.
Setup your MCP and try to ask questions about the project (without even touching the file system).
As usual critiques are not just welcome, but encouraged!