GAL - Governance Agentic Layer (VS Code Extension)
Sync your organization's approved AI agent configurations directly from VS Code.
Install
Search "GAL" in VS Code/Cursor Extensions, or:
code --install-extension scheduler-systems.gal-run
Usage
Status bar shows sync state. Click to:
- Login with GitHub
- Sync configuration
- Open dashboard
Features
- Status Bar - Shows sync state at a glance (synced, drifted, login required)
- Sidebar Dashboard - Browse workspaces, discovery results, approved configs, and proposals
- One-Click Sync - Pull approved config with a single click
- Hook Enforcement - Real-time notifications when policy hooks block actions
- Drift Detection - Alerts when local config diverges from approved config
Commands
| Command |
Description |
GAL: Check Status |
Refresh sync and auth status |
GAL: Sync Configuration |
Pull approved config (gal sync --pull) |
GAL: Login |
Authenticate with GitHub |
GAL: Open Dashboard |
Open web dashboard |
GAL: Propose Changes |
Submit a config change proposal |
GAL: Refresh Sidebar |
Reload sidebar data |
GAL: Install CLI |
Install GAL CLI globally |
Settings
| Setting |
Default |
Description |
gal.statusBar.enabled |
true |
Show GAL status in status bar |
gal.statusBar.position |
left |
Status bar position |
gal.refreshInterval |
300 |
Auto-refresh interval in seconds (0 = disabled) |
gal.cliPath |
gal |
Path to GAL CLI executable |
gal.dashboardUrl |
https://app.gal.run |
Dashboard URL |
Requirements
Requirements
- GAL CLI installed globally
- GitHub account with organization membership
Architecture
The extension uses Clean Architecture with four layers:
Extension Entry Point (Composition Root)
|
+-- Presentation StatusBarView, SidebarProvider (VS Code UI)
+-- Services StatusService, AuthService (business logic)
+-- Adapters ApiAdapter, CliAdapter (external I/O)
+-- Domain Pure types (GalStatus, AuthInfo, SyncInfo)
API calls use the shared SDK (@gal/api/client) - the same HTTP repos the CLI uses. See docs/vscode-clean-architecture.md for full architecture documentation.
Development
# Install dependencies
pnpm install
# Build (dev mode)
pnpm build
# Watch mode
pnpm watch # Extension host
pnpm watch:webview # Sidebar webview
# Run tests
pnpm test
# Package .vsix
pnpm package
Build Modes
| Script |
API URL |
Dashboard URL |
pnpm build (dev) |
localhost:3000 |
localhost:5173 |
pnpm build:publish |
api.gal.run |
app.gal.run |
Testing in VS Code
# Open extension in development host
code --extensionDevelopmentPath=apps/vscode-extension
Documentation
