Skip to content

Releases: Codesteward/codesteward-audit-proxy-plugins

v1.0.0

24 Mar 17:10

Choose a tag to compare

VSCode Extension

Initial release of the Codesteward Audit Proxy extension for VSCode.

Identity & Session Management

  • Auto-detect user email, project name, and branch from git
  • Watch .git/HEAD for branch changes and refresh automatically
  • UUIDv4 session ID persisted per workspace
  • Support identity overrides via IDE settings
  • Read .codesteward.json from repo root for shared team configuration
  • Config priority: IDE settings > repo config > auto-detected > defaults

Agent Support

  • Claude Code CLIANTHROPIC_BASE_URL, ANTHROPIC_CUSTOM_HEADERS
  • Codex CLIOPENAI_BASE_URL
  • Gemini CLIGEMINI_API_BASE_URL, GEMINI_CLI_CUSTOM_HEADERS
  • AiderANTHROPIC_BASE_URL, OPENAI_BASE_URL, AIDER_EXTRA_HEADERS
  • Cline — In-process process.env mutation for ANTHROPIC_BASE_URL, OPENAI_BASE_URL, ANTHROPIC_CUSTOM_HEADERS
  • Continue — In-process process.env mutation for ANTHROPIC_BASE_URL, OPENAI_BASE_URL
  • Per-agent enable/disable toggles in settings
  • Environment variables injected via EnvironmentVariableCollection API (persisted across terminal sessions)

Proxy Health Monitoring

  • Periodic health checks via GET /healthz with configurable interval
  • Warning notification on first connectivity failure
  • Auto-recovery detection when proxy comes back online

UI

  • Status bar widget — Shows connected/unreachable/disabled state with rich markdown tooltips; click to toggle
  • Header Inspector panel — Activity bar sidebar with tree view showing:
    • Connection status with proxy version
    • Active identity headers (User, Project, Branch, Session, Team)
    • Per-agent environment variable configuration
    • Custom headers from settings and repo config
    • Click-to-copy on all values
  • Refresh and health check toolbar actions
  • Welcome view with configuration prompt when proxy is not set up

Commands

  • Codesteward: Toggle Proxy — Enable/disable the proxy
  • Codesteward: Open Settings — Jump to extension settings
  • Codesteward: Show Header Inspector — Open the inspector panel
  • Codesteward: Copy Session ID — Copy current session ID to clipboard
  • Codesteward: Refresh Identity — Re-detect git identity
  • Codesteward: Check Proxy Health — Manual connectivity check

Onboarding

  • First-run guided setup: proxy URL input, identity confirmation, workspace/global scope selection
  • Automatic prompt when no proxy URL is configured

JetBrains Plugin

Initial release of the Codesteward Audit Proxy plugin for JetBrains IDEs (IntelliJ IDEA, PhpStorm, WebStorm, PyCharm, etc.). Requires 2024.1+.

Identity & Session Management

  • Auto-detect user email via git config, project name from workspace, branch via Git4Idea
  • UUIDv4 session ID persisted in workspace file
  • Support identity overrides via IDE settings (Tools > Codesteward Audit Proxy)
  • Read .codesteward.json from project root for shared team configuration
  • Config priority: IDE settings > repo config > auto-detected > defaults

Agent Support

  • Claude Code CLIANTHROPIC_BASE_URL, ANTHROPIC_CUSTOM_HEADERS
  • Codex CLIOPENAI_BASE_URL
  • Gemini CLIGEMINI_API_BASE_URL, GEMINI_CLI_CUSTOM_HEADERS
  • AiderANTHROPIC_BASE_URL, OPENAI_BASE_URL, AIDER_EXTRA_HEADERS
  • Per-agent enable/disable toggles in settings
  • Environment variables injected into every new terminal session via LocalTerminalCustomizer

Proxy Health Monitoring

  • Periodic health checks via GET /healthz with configurable interval
  • IDE notification on first connectivity failure with "Open Settings" action
  • Single initial connectivity check when periodic health checks are disabled
  • Auto-recovery detection when proxy comes back online
  • Diagnostic logging via IntelliJ Logger

UI

  • Status bar widget — Shows connected/unreachable/disabled/checking state; click to toggle proxy on/off
  • Header Inspector tool window (right sidebar) — Tree view showing:
    • Connection status with proxy version
    • Active identity headers (User, Project, Branch, Session, Team)
    • Per-agent environment variable configuration
    • Custom headers from settings and repo config
    • Double-click to copy values
  • Refresh and health check toolbar actions (heart icon for health)
  • Brand icon in plugin list and tool window

Actions

  • Toggle Proxy — Enable/disable the proxy
  • Open Settings — Jump to plugin settings
  • Show Header Inspector — Open the inspector panel
  • Copy Session ID — Copy current session ID to clipboard
  • Refresh Identity — Re-detect git identity
  • Check Proxy Health — Manual connectivity check with result notification

Onboarding

  • Startup notification when proxy is not yet configured, with "Configure" action to open settings

Settings (Tools > Codesteward Audit Proxy)

  • Proxy URL and enable/disable toggle
  • Identity fields: User, Project, Branch, Team
  • Per-agent checkboxes: Claude Code, Codex, Gemini, Cline, Aider, Continue
  • Health check enable/disable and interval (5–300 seconds)

Installation

VSCode

  1. Download the .vsix file from the assets below
  2. In VSCode, open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
  3. Run Extensions: Install from VSIX...
  4. Select the downloaded .vsix file
  5. Reload the window when prompted

JetBrains (IntelliJ IDEA, PhpStorm, WebStorm, PyCharm, etc.)

  1. Download the .zip file from the assets below
  2. Open Settings (Ctrl+Alt+S / Cmd+,) > Plugins
  3. Click the gear icon and select Install Plugin from Disk...
  4. Select the downloaded .zip file
  5. Restart the IDE when prompted