Getting Started

Welcome to Intentra! This guide will help you set up Intentra and start monitoring your AI coding costs.

Choose Your Setup Method

Intentra offers two ways to get started:

Both methods share the same account and can be used together.

Prerequisites

• macOS, Linux, or Windows
• One or more supported AI tools:
  • Cursor IDE
  • Claude Code
  • GitHub Copilot
  • Antigravity (Codeium-based, same hooks as Windsurf)
  • Windsurf
  • Gemini CLI

CLI Installation (Recommended)

The CLI is the recommended approach — it supports all AI tools, works across all platforms, and gives you full access to Intentra's feature set.

macOS / Linux

curl -fsSL https://install.intentra.sh | sh

macOS (Homebrew)

brew install atbabers/intentra/intentra

Windows (PowerShell)

irm https://install.intentra.sh/install.ps1 | iex

Verify Installation

intentra --version

You should see output like intentra version 0.1.0.

Login to Your Account

intentra login

This initiates device code authentication. Follow the on-screen instructions to authorize in your browser.

Verify authentication:

intentra status

Install Hooks

Install hooks for your AI tools:

intentra install

This installs hooks for all supported tools (Cursor, Claude Code, GitHub Copilot, Antigravity, Windsurf, Gemini CLI).

You can also install for specific tools only:

intentra install cursor          # Cursor only
intentra install claude          # Claude Code only
intentra install copilot         # GitHub Copilot only
intentra install antigravity     # Antigravity only (Codeium-based)
intentra install windsurf        # Windsurf only
intentra install gemini          # Gemini CLI only

Verify hooks are installed:

intentra hooks status

View Your Scans

Once hooks are installed, Intentra will automatically capture events as you use your AI tools.

intentra scan list

View detailed scan information:

intentra scan show <scan-id>

IDE Extensions

If you prefer a visual interface, Intentra offers extensions for popular IDEs. Extensions automatically install hooks and provide an in-editor dashboard.

Supported IDEs

VS Code / Cursor

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

Or install directly from the VS Code Marketplace.

Antigravity / Windsurf

1. Open Antigravity or Windsurf
2. Go to Extensions
3. Search for "Intentra"
4. Click Install

Using the Extension

1. Click the Intentra icon in the left Activity Bar
2. Click "Login to Intentra"
3. Complete authentication in your browser

That's it! The extension automatically installs hooks and captures your AI usage. View your scans and costs in the sidebar dashboard.

For more details, see the VS Code / Cursor Extension Guide.

What's Next?

• Core Concepts - Learn about events, scans, and normalization
• CLI Reference - All available commands
• Troubleshooting - Common issues and solutions