Documentation

Looper is a continuous improvement service. You point it at any work product, and it makes it better on a schedule. Automatically, intelligently, and forever.

Quick Start

Getting started with Looper takes three steps:

1. Create an account Sign up at looper.bot/dashboard. You'll get an API key and access to the dashboard immediately. No credit card needed.
2. Create your first loop Click "New Loop" in the dashboard. Choose what you want to improve (a GitHub repo, a URL, a file, or just paste some text), pick an improvement strategy, and set a schedule.
3. Let it run Looper will execute your loop on the schedule you set. Check your dashboard the next morning to see what improved. Every change is explained in plain language and can be reverted with one click.

Your First Loop

The fastest way to see Looper in action is to create a loop on something you already have:

• Have a GitHub repo? Connect it and choose the "Code Quality" strategy. Looper will find dead code, unresolved TODOs, and improvement opportunities.
• Have a website? Paste the URL and choose "SEO & Content." Looper will check for missing meta tags, broken links, and thin content.
• Have a document? Upload it or paste the text and choose "Documentation." Looper will find stale content, inconsistencies, and confusing passages.

Loops

A loop is the core unit of Looper. It connects three things together:

• A target - the thing you want to improve (code, docs, data, content)
• A strategy - the improvement approach (what to look for and how to fix it)
• A schedule - how often to run (nightly, weekly, or custom)

Each loop runs independently. You can have multiple loops on the same target with different strategies, or the same strategy on different targets. The free plan includes 2 loops.

Strategies

Strategies are the intelligence behind Looper. Each one encodes deep domain expertise about how to evaluate and improve a specific type of work.

Looper comes with 8 built-in strategies:

• Code Quality - dead code, TODOs, hardcoded values, error handling, naming drift
• Documentation - stale content, broken links, outdated references, confusing passages
• CRM Hygiene - duplicate contacts, stale deals, missing fields, data inconsistencies
• SEO & Content - meta tags, thin pages, keyword issues, internal linking gaps
• Marketing Plans - outdated audience data, unrealistic KPIs, completed campaigns
• AI Agents & Skills - prompt drift, contradictions, outdated tool references
• Spreadsheets - broken formulas, data outliers, format inconsistencies
• Processes & SOPs - ambiguous steps, outdated references, missing decision criteria

Pro and higher plans can create custom strategies tailored to your specific needs.

Targets

Looper can improve several types of targets:

• GitHub repositories - connect via OAuth, Looper reads your code and can open PRs with improvements
• URLs - point at any webpage, Looper fetches and analyzes the content
• Files - upload documents, spreadsheets, or data files directly
• Text - paste any text content for improvement

More target types (Google Sheets, Notion, CRM integrations) are coming soon.

Modes

You control how Looper applies improvements:

• Auto-apply - Looper makes changes directly. For GitHub, it opens PRs or commits to a branch. For other targets, it updates the stored version. Review changes anytime in the dashboard.
• Propose - Looper generates suggestions and waits for your approval. Review each improvement individually and accept, reject, or modify before applying.
• Monitor - Looper analyzes your target and reports findings without making any changes. Great for auditing, compliance, or getting a baseline understanding.

Runs & History

Every time a loop executes, it creates a run. Each run captures:

• What was observed (the state of your target)
• What improvements were identified
• What changes were made (with before/after details)
• Whether changes were verified as beneficial

Your dashboard shows the full history of every run. You can drill into any run to see exactly what changed, why it changed, and revert specific improvements if needed.

GitHub Integration

Connect your GitHub account to let Looper work directly with your repositories:

1. Go to Settings in your dashboard
2. Click "Connect GitHub"
3. Authorize Looper to access your repositories
4. When creating a loop, select "GitHub" as the target type and choose your repo

Looper can read any file in your repo and, in auto-apply mode, will create pull requests with its improvements so you can review and merge them through your normal workflow.

REST API

Everything in Looper is available through the REST API. Your API key is shown when you sign up (save it securely - it's only displayed once).

Base URL: https://api.looper.bot

Authenticate by including your key in the Authorization header:

Key endpoints:

• POST /api/loops - Create a new loop
• GET /api/loops - List your loops
• POST /api/loops/:id/run - Trigger a manual run
• GET /api/loops/:id/runs - View run history
• GET /api/templates - List available strategies

Badges

Show off your improvement streak! Add a Looper badge to your README or website:

The badge updates automatically with your total improvement count.

Plans & Billing

• Free - 2 loops, 60 runs/month, 7-day history
• Pro ($19/mo) - 10 loops, 300 runs/month, 90-day history, custom strategies, GitHub integration
• Team ($49/mo) - 50 loops, 1,500 runs/month, unlimited history, custom schedules
• Enterprise ($149/mo) - Unlimited everything, SSO, audit logs, dedicated support

Upgrade anytime from Settings in the dashboard. All plans include every built-in strategy and target type.

FAQ

What happens if Looper makes a bad change?

Every change is versioned. You can revert any individual improvement with one click from the run detail view. In Propose mode, nothing is applied until you approve it.

How much does each run cost in AI processing?

AI costs are included in your plan. You don't pay per-token or per-API-call. Your plan's run limit is the only constraint.

Can I run a loop manually?

Yes. Click "Run Now" on any loop in the dashboard, or use the API: POST /api/loops/:id/run.

Does Looper store my code or data?

Looper processes your content in memory during each run. It stores improvement diffs (the specific changes made) but not complete copies of your source material. GitHub tokens are encrypted at rest.

Can I use Looper on private repositories?

Yes. When you connect GitHub, you choose which repositories Looper can access. Private repos are fully supported.