Public beta · v0.1.0

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 · debug-signed build 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 — push, merge, deploy, and credentials each need a fresh yes
  • 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 — setup wizard, dashboard, playground, and autonomous runs in a WebView on 127.0.0.1. 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. Download the APK below — or grab it from the source repo and build it yourself with cli-os/scripts/build-apk.sh.
  2. Allow the install. This beta is sideloaded: Android will ask you to permit installs from your browser (Settings → “Install unknown apps”). That prompt is expected for any app outside the Play Store.
  3. Open L00prite OS. The gateway boots as a foreground service and the setup wizard walks you through your vault, your first AI provider, and your first token — keys stay on-device, sealed by the Android Keystore.
  4. Import a repo & run. Clone from a URL or import from device storage, open the Runs view, review the pre-flight, and type EXECUTE. Pushes, merges, and anything destructive still wait for your explicit approval.
Download l00prite-os-0.1.0-beta.apk15 MB · signed · SHA-256 verifiable
Android 8.0+ (API 26) arm64-v8a phones & tablets APK signature v2 + v3
SHA-256 ef9f8a025cbc93583f36c30d815e9cc76c69bbfbb33d2f055511d7dd4be36cdf SHA256SUMS ↗

This is beta software

LOOPRITE is under active development and this Android build is a beta: it is debug-signed, distributed 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 the APK from source and diff the checksum. 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 →