Install and configure the Whawit extension for VS Code, Cursor, Windsurf, and other compatible editors
The Whawit VS Code extension brings AI-powered observability directly into your editor. Query logs, analyze incidents, and get context-aware assistance without switching between tools.
Whawit extension sidebar showing projects, incidents, and analysis history
Features
Radar Chat
Ask natural language questions about your logs, metrics, and system health directly in the editor.
Context Search
Search your project’s knowledge base for architecture documentation, runbooks, and technical context.
Auto-detect Projects
Automatically matches your workspace to Whawit projects based on Git remotes.
Incident Management
View and manage incidents from connected observability providers without leaving your editor.
Prerequisites
VS Code 1.90.0 or later (also compatible with Cursor, Windsurf, and Kiro)
At least one project configured in Whawit with connected observability providers
Installation
Open VS Code
Go to Extensions (Ctrl+Shift+X or Cmd+Shift+X)
Search for Whawit
Click Install
The Whawit icon appears in your Activity Bar after installation.
Getting Started
1
Login to Whawit
Click the Whawit icon in the Activity Bar, then click Login to Whawit.The extension uses Auth0 for authentication. A browser window opens for you to complete the sign-in flow.
Your credentials are stored securely in VS Code’s secret storage and persist across sessions.
2
Select or auto-detect your project
If whawit.autoDetectProject is enabled (default), the extension automatically matches your workspace to a Whawit project based on Git remotes.To manually select a project:
Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
Run Whawit: Select Project
Choose from the list of available projects
The status bar shows your current project name when connected.
3
Open Radar Chat
Run Whawit: Open Radar Chat from the Command Palette or click the chat icon in the Projects view.
Radar Chat panel for querying logs and metrics
Ask questions like:
“Show me errors from the last 15 minutes”
“What’s causing high latency in the checkout service?”
“Are there any Redis connection issues?”
Activity Bar Views
The Whawit sidebar contains five views for managing your observability data:
Activity Bar views for projects, incidents, history, contexts, and integrations
Projects
Lists all Whawit projects you have access to. Click a project to select it as your working context. The currently matched project (based on your Git remote) is highlighted.
Incidents
Shows open incidents for the selected project. Each incident displays:
Severity level (critical, high, medium, low)
Summary and service name
Current status
Creation timestamp
Right-click an incident to send it to GitHub Copilot for analysis.
Analysis History
Displays recent DevOps analyses run on your project. Each entry shows:
Analysis title and status
Severity assessment
Timestamp
Click an entry to open the full analysis in an embedded browser panel.
Analysis details with root causes and recommendations
Contexts
Lists the project’s knowledge base contexts, including:
Repository documentation
Architecture overviews
User-defined technical context
These contexts power the semantic search and AI assistance features.
Integrations
Shows connected observability providers:
Datadog
AWS CloudWatch
New Relic
Google Cloud
Sentry
And more
Commands Reference
Command
Description
Whawit: Login
Authenticate with your Whawit account
Whawit: Logout
Sign out and clear stored credentials
Whawit: Open Radar Chat
Open the Radar chat panel for DevOps Q&A
Whawit: Select Project
Manually select a Whawit project
Whawit: Search Context
Search the project knowledge base
Whawit: Manage Integrations
Open the integrations management panel
Whawit: Analyze Current Workspace
Trigger an analysis of your current workspace
Whawit: Refresh Projects
Refresh the projects list
Whawit: Refresh History
Refresh the analysis history
Whawit: Refresh Incidents
Refresh the incidents list
Whawit: Open Web App
Open the Whawit web app in an embedded browser
Whawit: Send to Copilot for Fix
Send analysis to GitHub Copilot with fix instructions
Whawit: Copy as AI Prompt
Copy analysis as a formatted prompt for AI assistants
Configuration
Configure the extension through VS Code settings (Ctrl+, or Cmd+,):
Setting
Description
Default
whawit.autoDetectProject
Auto-detect project from Git remote
true
whawit.showStatusBar
Show Whawit status in the status bar
true
whawit.openAnalysisIn
Where to open analysis results (embedded or external)
embedded
AI Assistant Settings
Setting
Description
Default
whawit.aiAssistant.preferredFormat
Format when copying for AI (markdown, json, both)
markdown
whawit.aiAssistant.includeRawLogs
Include raw log events in AI prompts
false
whawit.aiAssistant.maxContextLength
Maximum context length in characters
10000
Project Auto-Detection
The extension automatically detects your Whawit project by matching Git remotes. The detection process:
Reads .git/config from your workspace folders
Extracts remote URLs (both HTTPS and SSH formats)
Normalizes URLs for comparison
Matches against repositories connected to your Whawit projects via GitHub integration
Auto-detection requires a GitHub integration configured in Whawit with access to your repository.
Troubleshooting
Extension not detecting my project
Ensure your repository is connected via a GitHub integration in Whawit
Verify the Git remote URL matches the repository URL in Whawit
Try running Whawit: Select Project manually
Check the Output panel (View > Output > Whawit) for error messages
Authentication issues
Run Whawit: Logout to clear stored credentials
Run Whawit: Login to re-authenticate
Radar Chat not responding
Verify you have a project selected (check the status bar)
Ensure the project has at least one log provider connected
Check your network connection to api.whawit.ai
Next Steps
GitHub Copilot Integration
Use @whawit in GitHub Copilot Chat for AI-assisted incident analysis.
MCP Server
Connect Claude, Cursor, and other AI assistants to Whawit via MCP.