The Infinium Cline Connector automatically captures your Cline (Claude Dev VS Code extension) tasks and sends structured traces to the Infinium platform, where Maestro — our behavioral intelligence engine — analyzes and scores agent performance.

No code changes required. Install the connector, run the setup wizard, flip one VS Code setting, and every Cline task is traced automatically.

Core Concept

Cline does the work. The connector captures what happened. Maestro evaluates how well it went.

The connector hooks into Cline’s event system and records facts — task descriptions, tool parameters, results, success/failure, durations, token usage — then sends them to Infinium as structured traces. Maestro interprets the trace and scores performance without the agent ever evaluating itself.

How It Works

Cline Task (in VS Code)
    │
    ├── TaskStart           ← Hook fires
    ├── UserPromptSubmit    ← Follow-up prompt
    ├── PreToolUse          ← Captures tool name + parameters
    ├── PostToolUse         ← Captures result, success, durationMs
    ├── TaskComplete        ← Task done → sends trace
    │   (or TaskCancel)
    │
    ▼
Infinium Connector
    │
    ├── Normalizes nested JSON payload
    ├── Writes JSON response to stdout (Cline requires this)
    ├── Aggregates events into structured turns
    ├── Reads ui_messages.json for token usage + cost
    ├── Builds: TaskData (steps, errors, tools, durations, llm_usage)
    ├── Sends: POST /agents/{id}/trace
    │
    ▼
Infinium Platform
    │
    └── Maestro evaluates trace quality and scores performance

Features

  • Zero-Config Tracing — Hooks install automatically into .clinerules/hooks/
  • Per-Task Traces — Each Cline task produces one summary trace on TaskComplete or TaskCancel
  • Tool Call Tracking — Captures every tool invocation with parsed parameters, result text, success flag, and duration
  • Token Usage + Cost — Reads Cline’s ui_messages.json for per-call token counts, cache reads/writes, and total cost
  • Secure Credentials — Agent secret stored in OS keyring (Windows Credential Manager, macOS Keychain, Linux Secret Service)
  • Per-Project Agents — Different projects can trace to different Infinium agents
  • Pause & Resume — Temporarily disable tracing without reconfiguring
  • Failed Trace Retry — Automatic recovery from network failures
  • Local History — View recently sent traces without leaving the terminal
  • Non-Blocking — Traces are built and sent in a detached background worker so Cline never stalls
GuideDescription
Getting StartedInstall, enable hooks in VS Code, setup wizard, verify connection
ConfigurationProject scope, credentials, environment variables
CommandsFull CLI reference for all infinium-cline commands

Reference

ReferenceDescription
Traced EventsWhat data is captured and how it maps to traces
TroubleshootingCommon issues and how to resolve them

Package Info

  • PyPI: infinium-cline-connector
  • CLI: infinium-cline
  • Python: >= 3.9
  • Dependencies: infinium-o2, click, keyring
  • License: MIT

Compatibility

  • Cline: v3.36 or newer (hooks must be enabled in VS Code → Settings → Extensions → Cline → Features → Enable Hooks)
  • Platforms: Windows, macOS, Linux — the connector auto-detects the right VS Code global storage path per OS