WTF FAQs

Question 1

What is WTF and how does it aid incident troubleshooting?

Accepted Answer

WTF (Why That Failed) is an AI-powered flight recorder specifically designed for incident troubleshooting within Claude Code. It automatically captures all tool calls, allows for manual observations, classifies events (actions, theories, breadcrumbs), and generates distilled incident timelines and runbook skeletons to significantly streamline the troubleshooting and post-incident analysis process.

Question 2

What kind of data does WTF capture?

Accepted Answer

WTF captures both automatic Claude Code tool calls and manual observations you log. This data is stored durably in a SQLite database, surviving context changes, and is then enriched through a background AI classifier.

Question 3

What are the prerequisites for installing and using WTF?

Accepted Answer

To use WTF, you'll need the Bun runtime, the Claude Code CLI (`claude`), `jq` (a JSON processor), and optionally AWS credentials for Bedrock if you want to enable the AI background classifier.

Question 4

Can I add my own notes or observations to the incident timeline?

Accepted Answer

Yes, you can easily add manual entries using the `/wtf now "your observation here"` command. These observations are then processed and classified by WTF's background AI, integrating them seamlessly into your incident timeline.

Question 5

How does WTF help with post-incident analysis and runbook generation?

Accepted Answer

WTF automatically generates an initial runbook skeleton (in Markdown) to `.wtf/runbook.md` based on the distilled incident timeline. This provides a structured starting point for refining into a reusable playbook for future incidents, accelerating post-mortem processes.

WTF

WTF

主要功能

使用案例

主要功能

使用案例