Universal Agent Support

VibeKit CLI provides universal support for popular coding agents, giving you consistent security, observability, and management features regardless of which AI coding assistant you use.

Supported Agents

Claude Code

Anthropic’s Claude Code CLI with enhanced security:

# Run Claude Code through VibeKit
vibekit claude "Help me refactor this React component"

# With sandbox enabled
vibekit claude --sandbox "Debug this API issue"

# Pass arguments directly to Claude CLI
vibekit claude --help

Gemini

Google’s Gemini with VibeKit protection:

# Run Gemini with VibeKit features
vibekit gemini "Generate a Python data analysis script"

# With sandbox isolation
vibekit gemini --sandbox-type docker "Write comprehensive tests"

Codex

OpenAI’s Codex with monitoring:

# Run Codex through VibeKit
vibekit codex "Convert this JavaScript to TypeScript"

# All VibeKit features apply to Codex
vibekit codex --sandbox "Generate production-ready code"

Grok

Grok by xAI with VibeKit protection:

# Run Grok with VibeKit features
vibekit grok "Generate a Go microservice"

# With sandbox isolation
vibekit grok --sandbox-type docker "Write comprehensive tests for the new microservice"

Cursor Agent

Cursor’s AI agent with VibeKit wrapper:

# Run Cursor Agent through VibeKit
vibekit cursor-agent "Help me implement this feature"

# With logging and proxy features
vibekit cursor-agent --sandbox-type podman "Review this code"

OpenCode

Open-source coding agent integration:

# OpenCode with VibeKit features
vibekit opencode "Help with Rust memory management"

# Full VibeKit feature support
vibekit opencode --sandbox "Optimize this algorithm"

Universal Features

Consistent Security

Every agent gets the same security protections:

Proxy Server: All agent traffic routed through redaction proxy
Sandbox Support: Optional Docker/Podman isolation for all agents
Redaction: Sensitive data removal across all agents
Logging: Structured logging for all agent interactions

Common Options

All agents support the same VibeKit options:

# Sandbox options work with any agent
vibekit [agent] --sandbox
vibekit [agent] --sandbox-type docker

# Global proxy configuration applies to all
vibekit [agent] --proxy http://localhost:8080

Unified Logging

Same observability features for all agents:

# View logs from any agent
vibekit logs --agent claude
vibekit logs --agent gemini
vibekit logs --agent codex
vibekit logs --agent grok

# Analytics for specific agents
vibekit analytics --agent cursor-agent

Cross-Agent Analytics

Compare and analyze different agents:

# View analytics across all agents
vibekit analytics

# Multi-agent breakdown shows performance comparison
# Output includes per-agent session counts, success rates, etc.

Configuration

Global Settings

VibeKit settings apply to all agents:

{
  "sandbox": {
    "enabled": false,
    "type": "docker"
  },
  "proxy": {
    "enabled": true,
    "redactionEnabled": true
  },
  "analytics": {
    "enabled": true
  }
}

Environment Variables

# Agent-specific API keys (set by underlying CLIs)
export ANTHROPIC_API_KEY="your-claude-key"
export GEMINI_API_KEY="your-gemini-key" 
export OPENAI_API_KEY="your-openai-key"
export GROK_API_KEY="your-grok-key"

# VibeKit global settings
export VIBEKIT_SANDBOX=true
export VIBEKIT_DEBUG=true

Settings Management

# Open settings interface (works for all agents)
vibekit

# Settings affect all agents uniformly

How Agent Wrapping Works

Command Forwarding

VibeKit acts as a wrapper around existing agent CLIs:

Forwards all unknown options to the underlying agent
Adds VibeKit-specific options (--sandbox, --sandbox-type)
Applies consistent logging, proxy, and analytics features

Example Flow

vibekit claude "help me code" --some-claude-option

# 1. VibeKit processes its own options (--sandbox, etc.)
# 2. Starts proxy server if needed
# 3. Forwards "help me code" and "--some-claude-option" to claude CLI
# 4. Logs the session and captures analytics

Agent Requirements

VibeKit assumes the underlying agent CLIs are installed:

claude command for Claude Code CLI
gemini command for Gemini CLI
codex command for Codex CLI
grok command for Grok CLI
cursor-agent command for Cursor Agent
opencode command for OpenCode

Current Implementation

What’s Implemented

Command Wrapping: All agents get proxy, logging, analytics
Consistent Options: Same sandbox and proxy options for all
Unified Analytics: Cross-agent session tracking and comparison
Settings Integration: Global settings affect all agents

Agent Status

All supported agents use the same architecture:

Proxy server for redaction (when enabled)
Structured logging to ~/.vibekit/logs/
Analytics tracking in ~/.vibekit/analytics/
Optional sandbox execution

Best Practices

Agent Selection

Choose agents based on their strengths:

Claude: Complex reasoning, detailed analysis
Gemini: Multimodal capabilities, diverse tasks
Codex: Code completion and generation
Grok: Real-time information and context
Cursor Agent: IDE-integrated workflows
OpenCode: Open-source flexibility

Consistent Workflow

Use same VibeKit options across agents for consistency
Monitor analytics to compare agent effectiveness
Apply same security settings (sandbox, redaction) to all agents
Regular log review for all agent activities

Security

Enable redaction for all agents handling sensitive code
Use sandbox mode when working with untrusted operations
Monitor proxy logs for unexpected data patterns
Keep all agent CLIs updated for security

Universal agent support provides a consistent security and observability layer across different AI coding assistants, letting you choose the best tool for each task while maintaining unified monitoring and protection.

Getting Started

Core Features

Configuration

Universal Agent Support

Supported Agents

Claude Code

Gemini

Codex

Grok

Cursor Agent

OpenCode

Universal Features

Consistent Security

Common Options

Unified Logging

Cross-Agent Analytics

Configuration

Global Settings

Environment Variables

Settings Management

How Agent Wrapping Works

Command Forwarding

Example Flow

Agent Requirements

Current Implementation

What’s Implemented

Agent Status

Best Practices

Agent Selection

Consistent Workflow

Security

​Supported Agents

​Claude Code

​Gemini

​Codex

​Grok

​Cursor Agent

​OpenCode

​Universal Features

​Consistent Security

​Common Options

​Unified Logging

​Cross-Agent Analytics

​Configuration

​Global Settings

​Environment Variables

​Settings Management

​How Agent Wrapping Works

​Command Forwarding

​Example Flow

​Agent Requirements

​Current Implementation

​What’s Implemented

​Agent Status

​Best Practices

​Agent Selection

​Consistent Workflow

​Security

Supported Agents

Claude Code

Gemini

Codex

Grok

Cursor Agent

OpenCode

Universal Features

Consistent Security

Common Options

Unified Logging

Cross-Agent Analytics

Configuration

Global Settings

Environment Variables

Settings Management

How Agent Wrapping Works

Command Forwarding

Example Flow

Agent Requirements

Current Implementation

What’s Implemented

Agent Status

Best Practices

Agent Selection

Consistent Workflow

Security