Skip to main content

Your First 5 Minutes

Open VS Code alongside this page and follow along.

Minute 1 — Open the Dashboard​

Click the UnfoldAI icon in the Activity Bar. The Dashboard loads with your workspace's current state. If this is your first time, it'll show a clean slate with an activity feed waiting for events.

Minute 2 — Open the UnfoldAI Terminal​

Run UnfoldAI: Open UnfoldAI Terminal from the Command Palette (Ctrl+Shift+U / Cmd+Shift+U).

The UnfoldAI Terminal is a dedicated terminal profile with enhanced command tracking. While UnfoldAI can monitor standard VS Code terminals too, the UnfoldAI Terminal provides the most reliable capture of command output.

tip

If you want UnfoldAI to monitor your normal VS Code/Cursor terminals too, keep Terminal > Integrated > Shell Integration enabled and reopen terminals after changing that setting. On Windows, prefer PowerShell / pwsh over cmd.

tip

You can also use Ctrl+Shift+Alt+U / Cmd+Shift+Alt+U to open a new UnfoldAI Terminal instance.

Minute 3 — Run an Agent and Watch the Feed​

Start your AI coding agent (Cursor, Claude Code, Copilot — whichever you use). Ask it to do something simple, like creating a utility function or fixing a lint error.

Switch back to the UnfoldAI Dashboard. You'll see the Activity Feed populating with events — commands executed, files changed, and any issues detected.

Minute 4 — Try the Chat​

Navigate to the UnfoldAI Agent tab (second tab in the sidebar navigation). Type a question like:

"What just happened in my workspace?"

UnfoldAI responds with context-aware information drawn from your current session — not generic answers, but analysis based on the actual commands and changes it observed.

Minute 5 — Check the Pre-Commit Summary​

Open the Command Palette and run UnfoldAI: Pre-commit Summary.

You'll see a breakdown of everything your agent changed: files modified, risk assessment, dependency changes, and a suggested commit message. Review the risk signals and verification checklist before committing.

You're Set​

You've experienced the core of UnfoldAI: monitoring, detection, contextual chat, and pre-commit review. Here's what to explore next:

  • Proactive Alerts — UnfoldAI will notify you when something needs attention, without you asking
  • Playbooks — Save solutions to recurring problems and have them auto-surface next time
  • MCP Integration — Let your AI agents query UnfoldAI for risk signals and session data
  • Drift Detection — Get alerted when agents loop or make no progress