Cheetah

AI-Assisted
Architecting

Distributed application substrate

Build the product. Inherit the distributed middle.

Cheetah is our connective substrate — a distilled ecosystem drawn from several projects we built or consulted on, across domains with little in common. It is one of the most important members of the set: at once a proof of the principles, the backbone the other systems run against, and the testbed where they are exercised rather than described.

What it distils is the work every distributed product keeps re-fighting: identity, connectivity, command delivery, coordination, local policy, structured results, and failure handling. A product defines its own operations. Cheetah moves them, governs them, and brings the answers back.

Design goal and role

Distilled, high-level components you can still read and change.

Flexible, vendor-agnostic, and scaling from a single process to a fully distributed, multi-user, multi-tenant deployment — components that absorb the problems every distributed product keeps re-fighting. The notoriously unreliable Chrome extension lifecycle is one of them: workers killed mid-operation, restrictions, disruption arriving at the worst possible moment. A laptop that sleeps halfway through a job and a second server process that never held the live connection produce the same shape of failure.

Where the defaults fit, a working ecosystem comes together in a few lines of code. Where they do not, the components stay understandable and replaceable — across environments, scales, client types and tasks.

Holding those fundamental problems inside the substrate is the point: they cannot leak upward into the interchangeable parts. What remains above the boundary is product code and boilerplate — the kind that can already be delegated to an AI assistant to implement and maintain, without anyone re-deriving distributed identity, retry semantics or stale-result handling each time.

The communication and execution protocol is deliberately extensible, so it carries the other efforts too: Imprint's distilled, declarative site knowledge can be delegated out to the perimeter, on demand and dynamically.

Working at this design level is solid material for raising builders to the architectural level — the elevation pillar, and Arboretum as our answer to it. And the complexity underneath, which belongs to the problems rather than to the code, is exactly what demands multi-angle analysis instead of operational debugging alone: elevated verification, and Paladin.

Where it fits. Cheetah is for products that issue named operations to identified clients whose runtimes may disappear, restart or move, where the result still needs policy, correlation and a durable record. It is not an event stream, not an ordinary service-to-service RPC layer, and not worth the weight for a single-process application that will stay one.

Where this stands

The Python server, shared TypeScript client core, browser client and console client run real products today.

01 · The problem

A proof of concept quietly becomes a distributed-systems project.

A product rarely arrives as a distributed system. It begins as a concept study or a sensible single-process application. Then another client appears, another machine, a browser extension, a user whose laptop sleeps halfway through an operation, and a second server process that does not hold the live connection.

A WebSocket delivering JSON takes an afternoon. Stable identity, late and duplicate results, restart safety, routing, durable history, approval, telemetry and failure handling are the actual work. Rebuilding that connective layer for each product consumes schedules and reproduces the same subtle failures.

Separately developed products, in different domains and at different scales, kept arriving at the same boundary: either the limits of an existing library, or a greenfield design repeating troubleshooting rounds someone else had already finished. Cheetah is that cross-project experience made reusable — and later products exercise it in new settings and feed the lessons back into the shared base.

02 · The granularity shift

Start with operations that matter to the product.

The goal is larger than a connection library. Someone building an application should spend attention on its meaningful commands, behaviours and decisions — not on recreating a distributed skeleton before the first product idea can run reliably.

The application boundary stays recognizable while the deployment grows. The same named operation runs through one in-memory process on a laptop, or across separate Redis-backed roles on several machines, without the product's command boundary changing.

AuthorNamed product operation
GovernSchema, capability, local policy
DeliverFind the live client instance
ReturnDurable structured result
The product defines the operation. Cheetah carries the recurring distributed concerns around it.

See one part of the system at a time.

The featured figure gives the page explanatory depth without turning it into documentation. Move through the set here, enlarge any figure, or open the complete visual guide.

The boards are offered, not imposed.

The same building blocks are also assembled into working interfaces for looking at a running system: a live workspace for issuing operations and inspecting what they returned, and a read-only diagnostics console for connections, capabilities and history. Take a board as it stands, take only the parts a product needs, or compose a different one from the same pieces.

01 / 12

The live workspace: what is connected, whether it is ready, and what has just run.
One browser client's windows and tabs, beside the actions it currently advertises.
One target, one command, optional evidence — chosen in a guided form.
The result keeps its capture: screenshot, data, HTML and raw response stay together.
Intent, progress, result and retained evidence in one chronology.
Worker windows run only after the operator confirms the profiles are isolated ones.
The same bounded run after it passed.
One operation: its outcome, the rules that allowed it, and what it actually touched.
The read-only diagnostics console: connections, pending calls, deduplication, pressure.
Client identity and heartbeat, with a plain reading of what they mean.
What a client advertises, and which arguments are checked before anything runs.
Durable history: the commands, the results, and the failures, kept as they happened.

03 · What remains solved

The machinery below the application boundary.

  • Identity across failure

    Stable client, runtime-instance and command identities distinguish reconnects, restarts, retries and stale responses.

  • Two directions, separated

    Stateful WebSocket delivery goes down; stateless response ingestion comes up through any eligible node.

  • Safety that composes

    Operations advertise schemas and capabilities, while local policy retains the final say over what executes on a machine.

  • Growth without a rewrite

    Server roles can share one process or separate into Redis-backed fleets without changing the product's command boundary.

04 · Technical depth

Go into the documentation when you need the machinery.

One maintained set, ordered the way the project intends it to be read and illustrated throughout: getting started, then the system explained, then building and operating it, with exact contracts at the end for anyone who needs the wire-level detail.

Cheetah coordinates where work runs. Imprint gives repeated browser work a deterministic way to return structured value, and Troveholm demonstrates both inside a small real product.

Next systemImprint

Make interpretation repeatable