GitHub

Specs are now the code. You need new tools.

Looper quietly watches the folders you already use, reads every spec and scratchy note, and wires them into one read-only index your whole team — and their agents — can reach. You write. Looper closes the loop.

macOS Windows Linux Local-first No telemetry

The problem

Docs belong with code. Specs belong somewhere else.

Specs are for building software, but don't belong in the same repos as the code that's changing. But we often find ourselves doing that out of convenience, and a lack of tooling. However, docs do belong next to the code it describes. Great specs should leverage existing docs — and now we have docs & specs all over the place. Looper solves these problems.

412

markdown files in your folders. You remember writing maybe thirty of them.

/docs

Every repo has one. Nobody opens it. The knowledge just quietly rots.

⌘F

Your search finds the filename you half-remember — never the idea you actually need.

How it works

Watches your docs. Syncs your specs. Touches nothing.

1

Point it at your folders

Pick the folders and git repos you already use. Looper leaves every file exactly where it is — nothing moves, nothing gets renamed.

2

Looper reads everything

It harvests every doc into a read-only index, follows the links between them, and keeps it live in the background while you get on with your day.

3

Find it. See it. Forget filing.

You, your team, and your agents all read from one source of truth. Search instantly, explore the graph, and watch it stay current as you write.

Team pattern

Specs-only repos

Keep a git repo of nothing but authoritative specs. Looper auto-syncs it and weights its docs as a higher grade of truth — the canon you and your agents reach for first.

AI · optional

Enrichment

Let an AI provider sharpen the index in place — summarize, cross-link, and raise the quality of the docs your agents read. Off by default; entirely your call.

What's in the box

Small app. Suspiciously capable.

Auto-harvest

New doc saved? It lands in the read-only index before you've switched windows. Zero filing, zero ceremony.

Always watching

A live file watcher keeps the index honest. Close the laptop mid-thought; it quietly catches up on launch.

Knowledge graph

The Viz view turns your pile of docs into a graph you can actually explore — clusters, links, the works.

Instant search

Full-text search across everything — ranked, fast, and local. The idea you needed, not just the filename.

Git-aware

Finds the repositories living in your folders and links them with a tidy .looper marker. No mess.

One calm dashboard

Recent, most-read, and freshly-indexed docs — your whole brain at a glance, the moment you open the app.

The home base

Meet the dashboard.

Open Looper and land somewhere useful: what you touched last, what you read most, and what's indexing right now.

  • Recently created & edited, live
  • Per-doc indexing status as it happens
  • Quick jump into search and the graph
looper — Dashboard

The big picture

See the whole web.

The Viz view draws every doc and the links between them. Spot the clusters, find the orphans, follow a thread you forgot you'd started.

  • Interactive force-directed graph
  • Click a node, jump to the doc
  • Updates as your knowledge grows
looper — Viz

Bring your own brain

You supply the key. We supply the loops.

Looper's enrichment features run on your agent — starting with Google's Gemini. Paste an API key once, or just reuse the GEMINI_API_KEY already sitting in the shell you launched from. Your key, your files, your machine.

No accounts. No telemetry. You only ever pay your provider for your own usage. We'll add support for more AI providers soon.

Looper's Gemini API key setting: Use GEMINI_API_KEY, or use a specified key.

Reuses the GEMINI_API_KEY from the shell Looper was launched from.

Reasonable questions

You probably want to ask…

Is it really free?

Yes. Free forever — you only ever pay your AI provider for your own usage, and that's between you and your API key.

What's with the name?

The app is Looper: as in, close the loop between AI and humans.

Do you see my files?

No. Looper is a local desktop app. Your docs and your API key never leave your machine — there's no server for them to leave to.

Which platforms?

macOS, Windows, and Linux. One app, three operating systems — it's built on Tauri, so it stays small and native-ish.

Will it reorganize my folders?

Never. Looper reads in place. The only things it ever optionally touches are .gitignore, .looperignore, and symlinks.

What agents do you support?

We've started with Gemini because of the value OKF brought to the project. Support for the other big AI providers is coming.

Your docs are in there. Go find them.

Download Looper — free

macOS · Windows · Linux · ~12 MB · no account