P# AutoAgents VS Code Extension

This extension provides VS Code commands for running AutoAgents (estel - https://github.com/Biodyn-AI/estel) tasks and chains.

Quick start

1. Install dependencies: npm install
2. Build: npm run compile
3. Run the extension via the VS Code extension host.

Configuration

• autoagents.workspacePath: Path to the estel repo root (defaults to the first workspace folder).
• autoagents.sessionId: Optional session id (sets AGENT_SESSION for commands).
• autoagents.verbose: Enable verbose agent output.
• autoagents.followAllByDefault: Auto-follow chains after starting autonomous mode.
• autoagents.autoStartContainer: Start the AutoAgents container automatically if needed.
• autoagents.targetSubpath: Optional subpath under the mounted target root to use as the Codex working directory.
• autoagents.targetPath: Absolute path to a target folder outside the AutoAgents workspace (mounted into the container).

UI

• "AutoAgents Studio" sidebar view provides the REPL with tabs (each tab maps to a chain), manual/auto chain buttons, a workspace switcher, and container status. Double-click a chain tab to rename it.
• "Main" tab shows all REPL activity; sending from it appends to the last active chain.
• Closing a chain tab stops that chain.
• "AutoAgents Tasks" tree view lists queued, working, done, and failed tasks plus recent chains.

Commands

• Queue control: "AutoAgents: Pause Queue" stops the agentd worker; "AutoAgents: Resume Queue" starts it again.
• Chain targeting: prompts that ask for a chain ID accept aliases plus blank, last, or current to target the most recent chain output.
• Host helper: "AutoAgents: Install CLI Wrapper" and "AutoAgents: Uninstall CLI Wrapper" manage the autoagents helper command.
• Diagnostics: "AutoAgents: Run Diagnostics" validates the workspace, Docker status, and recent daemon logs.
• Stats + wait: "AutoAgents: Show Task Stats (Custom)" adds session filtering; "AutoAgents: Wait for Task (No Stream)" waits without streaming status updates.
• Web UI: "AutoAgents: Open Web UI" supports custom workspace/port, browser suppression, and skipping the host helper.
• Results: "AutoAgents: Show Task Result" extracts the BEGIN_RESULT/END_RESULT or RESULT: block when available.
• Raw output: "AutoAgents: Show Raw Task Output" opens queue/runs/<id>/raw.txt when available.
• Run artifacts: "AutoAgents: Show Run Artifacts" opens prompt, metadata, status, output, or raw files from queue/runs/<id>.
• Session history: "AutoAgents: Show Session History" opens queue/sessions/<session>.repl.md (prompts you to pick a session if needed).
• Chain history: "AutoAgents: Show Chain History" opens queue/sessions/<session>.chain.<id>.repl.md for the selected chain.
• Chain notes: "AutoAgents: Show Chain Notes" opens queue/chains/<id>.note when present.