Public beta · v0.10.1-beta

LOOPRITE — loop once, loop right

LOOPRITE — glowing dot-matrix wordmark on a circuit board. Loop once, loop right.

The operating system for autonomous software engineering. LOOPRITE gives AI coding agents durable, file-based memory and a deterministic execution protocol — vendor-neutral, resumable, and gated by explicit human confirmation. Now running in your pocket.

BETA · release-signed Android 8.0+ arm64-v8a devices MIT-licensed source No cloud middleman
one protocol · every agent
01 · What LOOPRITE does

A small operating system
whose hardware is your repo.

AI coding agents forget everything between sessions, and every vendor locks that memory into its own proprietary state. LOOPRITE fixes both: it puts the agent's memory, plans, events, and safety rules into plain files inside your repository — readable and writable by any agent. Claude can plan, Codex can execute, Gemini can verify and respond to review comments, and whatever ships next can resume all of it from files. No backend. No hosted service. No lock-in.

memory

Durable memory

The .l00prite/ folder holds the blueprint, run ledger, durable decisions, constraints, known failures, and todos — the project's whole working memory as Markdown and JSON, versioned with your code.

processes

Loop prompts

Six canonical prompts — resume, heartbeat, event, review, handoff, execute — define exactly how any agent picks up the next unit of work, verifies it, and persists what happened before stopping.

interrupts

Events, not chaos

PR review comments and failed CI runs become first-class JSON events with a real lifecycle — pending → processing → completed — handled one at a time, always treated as untrusted input.

scheduler

Heartbeat control

heartbeat.json carries iteration budgets, continue/pause/stop signals, and review gates — so a loop knows when to keep going and when a human has to look first.

locks

Cooperative locking

A lock/lease convention (lock.json) keeps agents working close together in time from silently corrupting shared memory — check, acquire, respect, reclaim stale, release.

journal

Verified ledger

ledger.md records what actually happened, run by run, with the verification evidence — the commands that ran and what they proved. Progress you can audit, not vibes.

02 · Two operating modes

Plan freely. Execute intentionally.

Autonomy without a gate is a liability. LOOPRITE splits agent work into two modes — and the autonomous one can only be entered through an explicit, in-session human confirmation. Every run. No carry-over grants, and no persisted flag can ever stand in for you.

Mode 01 — default

Planning Mode

Clarifies requirements, generates a blueprint, scaffolds the repo and its .l00prite/ memory — then stops. Planning never executes the project it scaffolds, and always ships Execution Mode disarmed.

  • Blueprint first — goals, tiers, and constraints from a real conversation
  • Vendor adapters — AGENTS.md, CLAUDE.md, Cursor/Windsurf rules, Copilot instructions
  • Nothing runs — scaffold, hand over, stop
Mode 02 — armed by you

Execution Mode

Reads the blueprint and iterates autonomously — plan a unit, execute it, verify it with recorded evidence, persist memory, repeat — until Definition of Done or a run boundary stops it.

  • Pre-flight gate — goal, budget, boundaries and scope shown before you confirm
  • Nine run boundaries — from iteration_limit_reached to destructive_operation_required, every exit is resumable
  • Per-action approval — merge, deploy, and credential changes always need a fresh yes; push and pull-request creation do too by default, unless a project opts into the Auto-PR toggle to pre-approve just those two
  • Self-modification guard — the loop can never raise its own limits
03 · L00prite OS for Android

The whole control plane,
running on your phone.

The beta APK ships the unmodified LOOPRITE gateway as a native arm64 binary and runs it entirely on-device — guided first-run setup, a chat-first interface with cross-provider bridging, and autonomous runs in a WebView on 127.0.0.1. Bring your own keys — Claude, GPT, Gemini, Grok, Kimi and more. Your provider keys are sealed by an Android-Keystore-wrapped master key and never leave the device. There is no LOOPRITE cloud: your phone is the server.

  1. Prep your phone. Sideloading is off by default. On Android 8+ it's a per-app switch: Settings → Apps → Special app access → Install unknown apps → pick the browser you'll download with → Allow from this source. (On Samsung it lives under Settings → Security and privacy → Install unknown apps.) You can flip the switch back off as soon as you're done.
  2. Download the APK below — or grab it from the source repo and build it yourself with cli-os/scripts/build-apk.sh.
  3. Click through the warnings. Your phone will flag this install — from the browser, the installer, and Google Play Protect. That's the expected path for any app distributed outside the Play Store, not a sign something went wrong. The box below shows exactly what you'll see, why, and how to verify the file before you override anything.
  4. Open L00prite OS. The gateway boots as a foreground service and a three-step setup gets you chatting: connect your provider keys (validated live, sealed on-device by the Android Keystore), and you're in — no tokens to juggle.
  5. Import a repo & run. Clone from a URL or import from device storage, open the Runs view, review the pre-flight, and type EXECUTE. Merges, deploys, and anything destructive always wait for your explicit approval — pushes and pull-request creation do too, unless you opt a project into the Auto-PR toggle, which pre-approves just those two and shows up clearly in the pre-flight before you type EXECUTE.

Your phone will warn you — that's expected

This beta is signed with LOOPRITE's own release certificate (not Play Store, not a debug key) and delivered from looprite.click, so Android has no Play record to check it against and flags what it can't recognize. That's the expected consequence of sideloading — but don't override any warning on faith: verify the file's SHA-256 against the checksum below first, then proceed. Here's the sequence you'll see:

  • While downloading — Chrome may say “This type of file can harm your device.” Tap Download anyway.
  • When you open the file — if you skipped step 1, Android says “For your security, your phone is not allowed to install unknown apps from this source.” Tap Settings, flip Allow from this source, and go back.
  • Before it installs — Google Play Protect may offer to scan the app or show “Unsafe app blocked.” Check the SHA-256 before you decide: if it matches the checksum below, More details → Install anyway completes the install; if it doesn't match, stop — whatever you downloaded isn't this file, and the warning may be telling you something real.

Don't take our word for it: check the file's SHA-256 against the checksum below, and read the source to see exactly what you're running. (A self-built APK won't be byte-identical to this download — the build stamps a timestamp version code and signs with your own local key — so verify the published file by its SHA-256, not by diffing your own build.) Two hygiene tips: revoke Install unknown apps for your browser after installing, and if you installed 0.10.0-beta or earlier, uninstall it first — this is the first production-signed build, so Android will refuse an in-place update from the old debug certificate. Later 0.10.x builds signed with this same LOOPRITE certificate will update in place. Fair warning before you uninstall: it deletes everything the app stored on your device — provider keys, tokens, and imported repos — so you'll run setup again from scratch. Nothing is recoverable from a cloud, because nothing ever left your phone.

Download l00prite-os-0.10.1-beta.apk16 MB · signed · SHA-256 verifiable
Android 8.0+ (API 26) arm64-v8a phones & tablets APK signature v2 + v3
SHA-256 00a5ea009ae7595966857c775c0e9dbb3744d7020c8a28beb7cbfcf9890ce7f6 SHA256SUMS ↗

This is beta software

LOOPRITE is under active development and this Android build is a beta: it is release-signed, distributed from looprite.click outside the Play Store, and rough edges are expected. Point it at repos you can afford to experiment on, keep Execution Mode's approval prompts on, and expect breaking changes between releases. Found something weird? Open an issue — beta reports shape the release.

04 · Open source

Built in the open, on l00prite.

LOOPRITE is built off the l00prite source code — the vendor-neutral protocol, the gateway, the run engine, and this very APK pipeline are all MIT-licensed and public. Read the prompts your agents will follow. Audit the run boundaries. Build your own APK from the same source. That's the point.

github.com/jackofall1232/l00prite

Protocol spec, canonical loop prompts, vendor adapters, the Go gateway, the run engine, validators, and the hermetic Android build — one repo, MIT license.

Explore the code →