craft-ts-logs-mcp

Diagnose craft-ts demo application bugs from captured Console.* runtime logs.

3|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/craft-ts/craft-ts --skill craft-ts-logs-mcp-craft-ts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: craft-ts-logs-mcp
Source: https://github.com/craft-ts/craft-ts/tree/main/.agents/skills/craft-ts-logs-mcp
Command: npx skills add https://github.com/craft-ts/craft-ts --skill craft-ts-logs-mcp-craft-ts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a bug appears in the craft-ts demo application, guessing from source code wastes time. This Skill lets you investigate actual runtime evidence: logs captured by the local log server and exposed through the logs MCP bridge, so you can search, filter, and correlate real entries before touching any code. ## Core Features & Use Cases - Log-driven diagnosis: Run logs.stats, then logs.search filtered by level, from, correlationId, clientId, text, or time range to follow one correlated flow across components end to end. - Feature-wide instrumentation: Add a single provideFnWrapper in app.config.ts to log entry, exit, duration, and errors for every craft factory, instead of scattering Console.* calls. - Clean reproductions: Use logs.clear, re-run the exact failing steps, then logs.tail to read the result in emission order. - Troubleshooting empty pipelines: A checklist for when logs.search returns nothing — log server not running, LOG_SERVER_DIR mismatch, raw console.* calls, or buffered entries. - Use Case: A user reports the list page fails after navigation. You run logs.stats, search for error-level entries, take the correlationId of the failure, and retrieve every log of that flow across the route, service, and component hosts. ## Quick Start Use the craft-ts-logs-mcp skill to investigate why the demo application threw an error by searching the captured logs for error-level entries and following their correlationId.

Frequently Asked Questions about craft-ts-logs-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a bug in the craft-ts demo from runtime logs?▼

Start with logs.stats to see totals, levels, and host tags, then run logs.search with level error and warn. Take the correlationId of the relevant entry and search on it alone to retrieve every log of that flow across components before opening any source file.

How do I filter craft-ts logs by component or correlation id?▼

Use the from filter to match any tag in the host ancestry, such as a component or service name, and the correlationId filter to follow one flow end to end. Filters combine with AND, and results return newest first.

Why is logs.search returning no results in the craft-ts demo?▼

Common causes are the log server not running on port 4319, a LOG_SERVER_DIR mismatch between server and MCP reader, the demo not reloaded since provideLogForwarding was added, or code emitting raw console.* calls which are never forwarded.

Does the log forwarder capture raw console.log calls?▼

No. Only calls through the craft Console.* boundary are forwarded to the log server. Raw console.log calls appear only in browser devtools, and Console.trace, group, and time methods are not forwarded either.

How do I instrument a whole feature without adding logs everywhere?▼

Register one provideFnWrapper in app.config.ts, which wraps every craft factory and logs entry, exit, duration, and thrown errors. Inside the wrapper use yield* Console.* and HostTag() to read the host ancestry, then remove the wrapper after the investigation.

Is the craft-ts log server safe for production observability?▼

No. It is a loopback development tool with wide-open CORS and no authentication. The forwarder also drops failed batches silently and caps the buffer at 1000 entries, so it must not be presented as production observability.