Loop AI Assistant

An autonomous AI coding agent for Visual Studio Code.

Loop brings agentic AI directly into your editor—plan, build, refactor, and fix code through natural language. Connect your preferred AI provider, describe what you want, and Loop reads your workspace, creates and edits files, runs commands, and walks you through every change before it lands.

Features

Agentic coding

Agent mode — autonomous multi-step execution: read files, create and edit code, run terminal commands, and continue until the task is done
Chat mode — ask questions, get explanations, and explore code without modifying files
Understands requests in any language; infers stack, structure, and intent from your prompt

Workspace intelligence

Indexes your project and injects relevant context into every request
@file mentions to attach specific files to a conversation
Full-project context mode for architecture reviews and large refactors
Project memory — persists tech stack, preferences, and decisions across sessions

Safe, reviewable edits

Every file change is proposed as a diff — accept or reject before it is applied
Checkpoints — snapshot workspace state before writes and restore when needed
Read-only mode for explain/review tasks

Errors and quality

Detects Problems panel errors on open and offers Fix All
Real-time error watch with in-sidebar banners
Context-menu actions: Fix, Explain, Improve, Add tests

Developer experience

Inline ghost text completions while you type
Hover-to-explain for symbols and selections
Git integration: generate commit messages, review staged changes
Docs helpers: generate README, add comments, generate tests

AI providers

Loop supports multiple backends—use the one that fits your workflow:

Provider	How to connect	Best for
Gemini	API key from Google AI Studio	Fast responses, generous free tier
OpenRouter	API key from OpenRouter	Access to many models, including free options
GitHub	Sign in with GitHub	GitHub Models inference API

Configure providers in Loop Settings from the sidebar.

Requirements

Visual Studio Code ^1.85.0 or compatible (Cursor, VSCodium, etc.)
An API key or GitHub account for at least one supported provider
A folder opened in the editor (or let Loop create a project folder when none is open)

Installation

From source

git clone https://github.com/meersaadmarri/loop.git
cd loop
npm install
npm run compile

Press F5 in VS Code to launch the Extension Development Host with Loop loaded.

Package as VSIX

npm install -g @vscode/vsce
vsce package

Install the generated .vsix via Extensions → ··· → Install from VSIX.

Quick start

Open the Loop icon in the Activity Bar.
Click Settings and choose a provider (Gemini, OpenRouter, or GitHub).
Enter your API key or sign in.
Select Agent mode for code changes, or Chat for questions only.
Describe what you want—for example:
- Create a REST API with Express and TypeScript
- @index.html remove the header section
- Fix all errors in this project

Review proposed diffs and click Accept or Reject for each file.

Keyboard shortcut

Action	macOS	Windows / Linux
Focus Loop chat input	`Cmd+Shift+K`	`Ctrl+Shift+K`

Commands

Command	Description
`Loop: Open Chat`	Open the Loop sidebar
`Loop: Focus Chat Input`	Jump to the chat input
`Loop: Fix this`	Fix selected code
`Loop: Explain this`	Explain selected code
`Loop: Improve this`	Refactor selected code
`Loop: Fix All Errors`	Fix workspace errors
`Loop: Generate Commit Message`	AI commit message from staged changes
`Loop: View Checkpoint History`	Restore a previous snapshot
`Loop: Edit Project Memory`	Manage stored project context

Right-click in the editor for additional Loop actions on selections and files.

Project structure

Loop/
├── src/
│   ├── agent/          # Agent core, file ops, checkpoints, error watching
│   ├── auth/           # Gemini, OpenRouter, GitHub authentication
│   ├── completion/     # Inline ghost-text completions
│   ├── git/            # Git-aware AI commands
│   ├── memory/         # Project memory persistence
│   └── ui/             # Sidebar and settings webviews
├── media/              # Sidebar and settings HTML/CSS
├── resources/          # Extension icons and assets
├── LICENSE
└── README.md

Development

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode
npm run watch

# Type-check without emit
npm run lint

Provider notes

Gemini free tier is limited to roughly 15 requests per minute. Loop queues requests and retries automatically; for heavy use, consider OpenRouter or a paid tier.
OpenRouter may return credit-limit errors on small balances. Loop retries with a lower token budget; free models are listed in OpenRouter models.
API keys are stored in the VS Code Secret Storage API and are never written to disk in plain text.

Contributing

Contributions are welcome. Please open an issue to discuss significant changes before submitting a pull request.

Fork the repository
Create a feature branch (git checkout -b feature/your-feature)
Commit your changes (git commit -m 'Add your feature')
Push to the branch (git push origin feature/your-feature)
Open a Pull Request

License

This project is licensed under the MIT License. See LICENSE for the full text.

Author

Meer Saad Marri — github.com/meersaadmarri

If Loop helps your workflow, consider starring the repository.