EL-clgt

EL-clgt is a local-first VSCode AI coding agent extension. It follows the architecture in plan.md: a sidebar UI, workflow engine, local repository intelligence, tool safety checks, provider adapters, and HTML task summaries.

How It Works

The extension runs inside VSCode and stores workspace data locally under .myagent/.

• src/extension.ts activates the extension, registers commands, and attaches the sidebar provider.
• src/sidebarProvider.ts renders the sidebar webview with Chat, Providers, Agents, and Settings tabs.
• src/messageRouter.ts handles the webview-to-extension message contract.
• src/stores.ts stores provider metadata and agent profiles locally while keeping API keys in VSCode SecretStorage.
• src/agentRunner.ts connects the active agent to its provider, workflow, repository context, and summary generation.
• src/indexer.ts scans the workspace, creates local file, symbol, dependency, and mindmap outputs.
• src/workflows.ts defines the built-in workflows: Architect -> Code, Architect -> Code -> Build/Test, Architect -> Code -> Build/Test -> Document, and Question Mode.
• src/providers.ts contains the provider adapters. OpenAI and Anthropic use API keys from SecretStorage; Copilot is UI-ready and deferred for direct chat API support.
• src/tools.ts provides workspace-local file and terminal operations.
• src/safety.ts blocks risky operations unless approved or explicitly auto-approved in settings.
• src/summary.ts writes HTML reports to .myagent/reports/summary-<timestamp>.html.

Generated local storage:

.myagent/
├── index/
│   ├── symbols.json
│   ├── dependencies.json
│   ├── callgraph.json
│   └── file-map.json
├── mindmaps/
│   ├── architecture.md
│   └── modules.md
├── workflows/
├── prompts/
├── reports/
└── settings.json

Requirements

• Node.js 20+
• VSCode 1.90+
• npm

Install Dependencies

npm install

Build

npm run build

This compiles TypeScript from src/ to out/.

Run In VSCode

1. Open this folder in VSCode.
2. Run npm install.
3. Run npm run build.
4. Press F5, or open the Run and Debug panel and select Run EL-clgt Extension.
5. In the Extension Development Host window, open the EL-clgt activity bar item.

Use The Extension

• Click Index to scan the current workspace and generate .myagent/index/* and .myagent/mindmaps/*.
• Select a workflow from the sidebar.
• Enter a task and click Run.
• Enter a terminal command and click Run Command to execute it with safety checks.
• Click Summary to generate an HTML report.

Settings

Configure these in VSCode settings:

API keys are entered in the Providers tab and saved with VSCode SecretStorage, not plain JSON settings.

{
  "elClgt.autoApproveCreateFile": true,
  "elClgt.autoApproveEditFile": true,
  "elClgt.autoApproveInstall": false,
  "elClgt.autoApproveDelete": false,
  "elClgt.autoApproveGit": false
}

Current MVP Scope

Implemented:

• TypeScript VSCode extension scaffold
• Sidebar webview UI with Chat, Providers, Agents, and Settings tabs
• Provider connection management for OpenAI and Anthropic
• SecretStorage-backed API key handling
• Local agent profile creation, duplication, deletion, and active selection
• Chat execution through the selected active agent
• Built-in workflow templates
• OpenAI and Anthropic provider adapters
• Workspace-local repository index
• Architecture and module mindmap generation
• Command safety approval checks
• HTML task summary generation

Planned next:

• Streaming responses
• Real patch application from model output
• Incremental indexing through file watchers
• Visual custom workflow builder
• Direct Copilot, Ollama, LM Studio, OpenRouter, and Gemini adapters