The ultimate AI-Agent oversight and tracking extension for VS Code (and compatible IDEs).
Stop letting CLI AI agents blindly overwrite your codebase. Stavreng gives you full transparency and granular control over every single line of code your AI tries to modify. It is especially powerful for users running Local LLMs, but is equally useful for tracking any standard CLI coding agent (like Claude Code, Aider, etc.). Works seamlessly in VS Code, Antigravity, Cursor, VSCodium, and other compatible IDEs.
✨ Why Stavreng?
When you run a coding agent in a standard terminal, it edits your files directly on disk. If it makes a mistake, clobbers a recent change you made, or rewrites a function poorly, your only defense is digging through git diff manually or relying on massive git undo commands that wipe out your own manual work too.
Stavreng fixes this by intercepting those changes locally and treating them as "Pending Proposals".
🚀 Key Features
Integrated Agent Terminal UI: Run claude, agy, aider, or any local LLM interactive CLI natively inside the Stavreng sidebar.
Granular File Review & Diffing: Click on any file in the "Pending" state within the Stavreng sidebar to instantly open a side-by-side diff. Compare the exact "baseline" state of the file before the AI touched it against the AI's live changes.
Surgical Rollbacks (Hunk-by-Hunk): Don't like a specific loop the AI wrote? Review the diff and click "Reject" to surgically roll back just that code block without losing the manual edits you made somewhere else in the file! (All accepts and rejects update the live editor in real-time).
Session Timeline: A visual, interactive history of every AI session. Safely open previous sessions to read chat logs or review past file modifications.
📦 Installation
Since this extension is currently in open-source beta, you can install it manually:
Go to the Releases page of this GitHub repository.
Download the latest stavreng-x.x.x.vsix file.
Open VS Code, go to the Extensions panel.
Click the ... menu at the top right and select Install from VSIX.
Select the downloaded file.
🎯 How to Use
Open the Stavreng icon in your VS Code Activity Bar.
Pro Tip: For the best agentic workflow, right-click the Stavreng icon and select Move to Secondary Side Bar. This allows you to keep your main file explorer open on the left while tracking the AI on the right!
In the terminal at the bottom, launch your favorite agent (e.g. type claude or run your local LLM CLI).
Ask the AI to build something!
As the AI modifies your files, you will see the changes tracked in the UI above the terminal as "Pending".
Click a specific file to review the diff side-by-side. Use the Accept All (check) or Reject All (trash) buttons to approve or revert changes.
When you are done, click New Terminal to safely clear the session and start fresh.
⚠️ Important Cautions & Best Practices
Resolve Pending Changes First: After an AI agent makes edits to a file, always make sure to either Accept or Reject those changes before editing those same files directly (especially the lines of code modified by the agent). Resolving pending agent modifications first ensures the local tracker remains in sync and prevents conflicts between manual edits and the AI's proposal.
🤝 Contributing
We welcome open-source contributions! To get started:
Clone this repository.
Run npm install to grab the dependencies.
Run npm run compile to build the extension.
Press F5 in VS Code to launch the Extension Development Host and test your changes live.
