Automus is a local AI Coding Agent embedded directly into your VS Code editor. It allows you to chat with your codebase, automate file edits, and inspect/explore your project structure—powered by your own Google Gemini or OpenRouter API keys.
Key Features
- 🛠️ ReAct Coding Agent: Automus inspects and updates files on your behalf.
- 🔍 Workspace Context: Automatically pulls context from active/referenced code files.
- 🎨 13 Premium Themes: Choose from deep cobalt slates, solarized yellow, cyberpunk gold, and a warm sakura pink to match your editor aesthetic.
- 🔒 Security Sandbox: Encapsulated within your workspace. Path traversal blocks and a sensitive file filter (e.g.
.env, SSH keys) prevent unauthorized system access or token leakage. - ⚡ Animated Status Indicator: Engages a pulsing gradient waveform showing you exactly what step the AI is working on (Thinking, Reading, Writing, etc.).
- 🔄 Auto-Apply & Diff Cards: Toggle Auto-apply off to review full side-by-side green/red code diffs before allowing any file writes.
Getting Started
- Click the Automus sidebar icon.
- Select your AI provider (Office account or Personal keys).
- Switch your theme from the dropdown header.
- Prompt the AI:
@src/main.js refactor this file...
Publishing & Local Setup
To Install and Run Locally
If you want to package the extension to install it manually or share with others:
# Package the extension into a VSIX file
npx @vscode/vsce package --allow-missing-repository
To install the resulting .vsix file locally:
code --install-extension automus-1.0.0.vsix