VS Code Extension

The Intentra VS Code Extension provides a visual interface for monitoring your AI coding costs directly within your editor. It works with VS Code, Cursor, and any VS Code-compatible IDE.

Installation

From VS Code Marketplace

Open VS Code or Cursor
Go to Extensions (Cmd+Shift+X on Mac, Ctrl+Shift+X on Windows/Linux)
Search for "Intentra"
Click Install

Or install directly from the VS Code Marketplace.

From VSIX File

If you have a .vsix file:

Open VS Code or Cursor
Go to Extensions (Cmd+Shift+X)
Click the ... menu (top-right of Extensions panel)
Select Install from VSIX...
Choose the intentra-x.x.x.vsix file

Getting Started

Step 1: Open the Sidebar

Click the Intentra icon in the Activity Bar (left sidebar). You'll see the Intentra panel with a welcome message.

Click the "Login to Intentra" button. Your browser will open to complete authentication. Once logged in, the sidebar will display your dashboard.

Step 3: Start Using AI Tools

The extension automatically installs hooks for your AI coding tools. As you use Cursor, Copilot, or other supported tools, Intentra captures usage data in the background.

Sidebar Dashboard

Once logged in, the sidebar shows:

Scans Today - Number of AI interactions captured
Tokens - Total tokens used
Est. Cost - Estimated cost for the day
Recent Scans - List of recent AI interactions with model and cost
Violations - Detected wasteful patterns (retry loops, excessive context, etc.)

Available Actions

From the Sidebar

Refresh - Update the dashboard with latest data
Dashboard - Open the full Intentra web dashboard
Logout - Sign out of Intentra

From Command Palette

Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux) and type "Intentra":

Intentra: Login - Sign in to your account
Intentra: Logout - Sign out
Intentra: Open Dashboard - Open intentra.sh in browser
Intentra: Refresh Status - Refresh the status bar and sidebar
Intentra: Show Sidebar - Open the Intentra panel

Status Bar

The status bar (bottom of the editor) shows a quick summary of your current session. Click it to open the sidebar.

Settings

Configure the extension in VS Code Settings (Cmd+,):

Setting	Default	Description
`intentra.autoInstallHooks`	`true`	Automatically install hooks on login
`intentra.statusBarEnabled`	`true`	Show Intentra in the status bar
`intentra.refreshInterval`	`60`	Status refresh interval (seconds)

Supported Tools

The extension automatically detects and configures hooks for:

Cursor - AI-powered code editor
GitHub Copilot - AI pair programmer
VS Code with AI extensions

Troubleshooting

Extension Not Appearing

Ensure the extension is installed and enabled
Reload the window (Cmd+Shift+P → "Developer: Reload Window")

Check your internet connection
Ensure port 54321 is not blocked (used for OAuth callback)
Try logging out and back in

Hooks Not Capturing Events

Check ~/.intentra/handler.log for errors
Verify hooks are installed: look for hook configuration in your tool's settings
Restart your AI coding tool

Session Expired

If you see "Session expired", click Login to re-authenticate. The extension will automatically refresh tokens when possible.

CLI vs Extension

Feature	CLI	Extension
Installation	Terminal command	Marketplace install
Login	`intentra login`	Click button in sidebar
View scans	`intentra scan list`	Sidebar dashboard
Hook management	`intentra install/uninstall`	Automatic
Best for	Power users, automation	Visual users, beginners

Both the CLI and extension share the same credentials stored securely in your OS keychain (macOS Keychain, Linux Secret Service, or Windows Credential Manager) and can be used together.

What's Next?

Core Concepts - Learn about events, scans, and violations
Troubleshooting - Common issues and solutions
CLI Reference - Command-line interface documentation