Getting Started
Choose your path into Loop based on how you want to integrate — quickstart, agent setup, SDK, CLI, or MCP server.
Getting Started
Loop is the autonomous improvement engine — an open-source data layer and prompt engine that collects signals, organizes work into issues, and tells AI agents exactly what to do next. There is no AI inside Loop. It is a fully deterministic system that any agent can pull work from over HTTP.
New to Loop?
If this is your first time, start with the Quickstart below. You will go from zero to a dispatched issue in under five minutes.
Choose Your Path
Pick the entry point that matches what you are trying to do.
First Steps
Quickstart
Go from zero to a working agent loop in five minutes. Connect your project, create an issue, and dispatch it to an AI agent.
API Keys
Generate and configure loop_ prefixed API keys for authenticating with the Loop API.
Authentication
Understand Bearer token auth for API requests and HMAC signature verification for webhooks.
Connect an AI Agent
If you are building an autonomous agent workflow and want your agent to pull tasks from Loop, pick the integration surface that fits your setup.
Agent Integration Guide
Choose the right integration for your AI agent — Claude Code, Cursor, Windsurf, OpenHands, or a custom agent.
MCP Server
Zero-code IDE integration via the Model Context Protocol. Install in one command and get 9 agent tools.
Agent Skill
Drop a SKILL.md into your repo so AI agents automatically discover how to use Loop in your project.
Build with the SDK or CLI
If you are writing custom scripts, building integrations, or managing Loop from the terminal.
TypeScript SDK
Type-safe programmatic access to the Loop API. Use it in custom applications, scripts, and agent frameworks.
CLI Reference
Manage issues, signals, triage, templates, dispatch, and system health from the command line.
Understand the System
Core Concepts
Learn the building blocks: issues, signals, dispatch, prompt templates, projects, and goals.
API Reference
Complete REST endpoint reference for issues, signals, templates, dispatch, and dashboard.
Self-Hosting
Deploy Loop on your own infrastructure with environment configuration and deployment guides.
Prerequisites
Before running Loop locally, make sure you have:
- Node.js 20+ installed
- Docker installed and running (for local PostgreSQL)
- pnpm (install via
npm install -g pnpmor see pnpm.io)
For production deployments, you will need a Neon PostgreSQL database. For local development, Loop provides a Docker Compose configuration that runs PostgreSQL automatically.