Releases: Codesteward/codesteward-audit-proxy-plugins
Releases · Codesteward/codesteward-audit-proxy-plugins
v1.0.0
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/HEADfor branch changes and refresh automatically - UUIDv4 session ID persisted per workspace
- Support identity overrides via IDE settings
- Read
.codesteward.jsonfrom repo root for shared team configuration - Config priority: IDE settings > repo config > auto-detected > defaults
Agent Support
- Claude Code CLI —
ANTHROPIC_BASE_URL,ANTHROPIC_CUSTOM_HEADERS - Codex CLI —
OPENAI_BASE_URL - Gemini CLI —
GEMINI_API_BASE_URL,GEMINI_CLI_CUSTOM_HEADERS - Aider —
ANTHROPIC_BASE_URL,OPENAI_BASE_URL,AIDER_EXTRA_HEADERS - Cline — In-process
process.envmutation forANTHROPIC_BASE_URL,OPENAI_BASE_URL,ANTHROPIC_CUSTOM_HEADERS - Continue — In-process
process.envmutation forANTHROPIC_BASE_URL,OPENAI_BASE_URL - Per-agent enable/disable toggles in settings
- Environment variables injected via
EnvironmentVariableCollectionAPI (persisted across terminal sessions)
Proxy Health Monitoring
- Periodic health checks via
GET /healthzwith 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 proxyCodesteward: Open Settings— Jump to extension settingsCodesteward: Show Header Inspector— Open the inspector panelCodesteward: Copy Session ID— Copy current session ID to clipboardCodesteward: Refresh Identity— Re-detect git identityCodesteward: 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.jsonfrom project root for shared team configuration - Config priority: IDE settings > repo config > auto-detected > defaults
Agent Support
- Claude Code CLI —
ANTHROPIC_BASE_URL,ANTHROPIC_CUSTOM_HEADERS - Codex CLI —
OPENAI_BASE_URL - Gemini CLI —
GEMINI_API_BASE_URL,GEMINI_CLI_CUSTOM_HEADERS - Aider —
ANTHROPIC_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 /healthzwith 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 proxyOpen Settings— Jump to plugin settingsShow Header Inspector— Open the inspector panelCopy Session ID— Copy current session ID to clipboardRefresh Identity— Re-detect git identityCheck 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
- Download the
.vsixfile from the assets below - In VSCode, open the Command Palette (
Ctrl+Shift+P/Cmd+Shift+P) - Run Extensions: Install from VSIX...
- Select the downloaded
.vsixfile - Reload the window when prompted
JetBrains (IntelliJ IDEA, PhpStorm, WebStorm, PyCharm, etc.)
- Download the
.zipfile from the assets below - Open Settings (
Ctrl+Alt+S/Cmd+,) > Plugins - Click the gear icon and select Install Plugin from Disk...
- Select the downloaded
.zipfile - Restart the IDE when prompted