Episode Tracking
An Episode is UnfoldAI's core detection unit — a grouped bundle of related events centered around an error or issue in your workspace.
How Episodes Work
When UnfoldAI detects an error pattern — a failing command, an accumulating set of problems, or a repeated failure — it creates an Episode that bundles the relevant context together: the commands that led to the error, the terminal output, file changes, and related events.
Episodes appear as prominent cards on the Dashboard and as proactive alert messages in the conversation stream.
Episode Lifecycle
- Detection — UnfoldAI identifies an issue and creates the Episode
- Investigation — You review the bundled evidence and context
- Resolution — The issue is fixed (detected automatically or marked manually)
- Memory — You can save the solution as a Playbook for future reference
What's Inside an Episode
Each Episode contains:
- Error signature — A summary of what went wrong
- Timeline — The sequence of events leading to and surrounding the error
- Terminal output — Relevant command output and error messages
- File context — Which files were involved
- Agent attribution — Which agent was active when the issue occurred
Actions
From an Episode card, you can:
| Action | Description |
|---|---|
| Investigate | Open the full Episode view with all evidence |
| Chat | Start a conversation with Episode context pre-loaded |
| Fix Plan | Request an AI-generated resolution plan |
| Report | Generate a debug report |
| Save Playbook | Store the resolution for future reference |
| Dismiss / Mute | Dismiss the Episode if it's not relevant |
Configuration
You can tune Episode detection behavior:
// settings.json
{
// Minimum severity level for VS Code Problems panel issues to trigger episodes
// Options: "error" | "warning" | "info" | "hint"
"unfoldai.episodes.problemMinSeverity": "error",
// Minutes of no new related events before an episode auto-resolves
"unfoldai.episodes.resolveQuietMinutes": 5,
// How far back (in minutes) to look for related events when grouping
"unfoldai.episodes.maxLookbackMinutes": 15
}
Availability
| Feature | Free | Pro | Ultra |
|---|---|---|---|
| Episode detection & display | ✅ | ✅ | ✅ |
| Episode investigation | ✅ | ✅ | ✅ |
| AI-powered fix plan | Limited | ✅ Unlimited | ✅ Unlimited |
| Debug report generation | Limited | ✅ Unlimited | ✅ Unlimited |
| Episode chat | ✅ (daily limit) | ✅ Unlimited | ✅ Unlimited |