📅 Book a 30-min Demo📞 Call/text (571) 293-0242

Part IV · The Client Layer

Chapter 13One Backend, Every Surface

5 min readFrom Sovereign AI Engineering by Miguel AmigotLast updated
Share
A platform that only exists as a web app has decided where its users may work. That is not the platform's decision to make.

The data layer described in Part III is invisible to the people it serves. What they see is a client: a chat window on the web, a side panel in the browser, an app on a laptop or a phone, a command in a terminal. This chapter is about why a sovereign platform has to show up on all of those surfaces from one backend, and what that requires of the engineering.

Where the work actually happens

A CIO buying an AI platform is told to imagine users opening a web application, typing a question, and reading an answer. Some work happens that way. Most does not.

An advisor spends the day inside the student information system and the advising platform. A recruiter lives in the CRM and LinkedIn. A clinician works in the electronic health record. A lawyer works in a document editor and a matter management system. A finance analyst works in spreadsheets and the ERP. An engineer works in a terminal and an editor. The common property is that the work has a surface already, and the surface is not the AI vendor's web page.

An AI platform that requires people to leave their work, open a separate application, paste context into it and carry the answer back has a ceiling on its usefulness that no model improvement will lift. The platform has to meet people where they are: in the browser tab they have open, on the desktop they use, on the phone in their hand, in the terminal where the automation runs.

Seven surfaces, one codebase

The platform I work on ships to seven surfaces, and the list is a reasonable specification for what a CIO should expect.

The web. The full application, in any browser, with nothing to install. The default for most people most of the time.

The browser. A Chrome side panel that puts the same agents on whatever page the person is on, reads the tab as context, and, when asked, acts on the page. Chapter 15 is about it.

macOS and Windows. Native desktop applications, signed and notarized, with the same interface and the additional abilities a desktop grants: local files, system integration, a runtime that can drive other applications under the user's supervision.

iOS and Android. Phone and tablet applications in the two stores, for the person who is not at a desk.

Linux. Built from source, because the people who run Linux desktops generally prefer it that way, and because the source is theirs to build.

The terminal. A headless surface: the platform's operations exposed as skills that a coding agent or a script can call, so an administrator can create agents, configure models, manage users and pull analytics with no interface at all. Chapter 19 returns to this.

What matters is not the count but the word "one." These are one backend, one identity system, one set of agents and one memory, presented seven ways. A conversation started in the side panel is waiting in the desktop app. A model switched by an administrator changes for every surface at once. A connector added to the broker is reachable from the phone.

What a native shell adds

It is fair to ask why a desktop or mobile application is worth building when the web version works. Three reasons, in order of importance.

Presence. An application in the dock or on the home screen is used; a bookmark is forgotten. For an institution trying to make an AI platform the default place its people turn, the difference in adoption is large.

Capability. A desktop application can read local files, watch a folder, drive other applications on the person's behalf through the operating system's own automation interfaces, and run a local model when the hardware allows it. A browser tab can do none of that. For the agents in Part V, which act rather than merely answer, the desktop is where the acting happens.

Control. A native application can be built against the institution's own deployment, locked to its organization, and distributed through the institution's device management. An air-gapped institution builds its own, pointed at its own host. A web page cannot be handed to a device-management system.

The engineering that makes this affordable is a shell: a thin native wrapper around the same web application, so that the interface is written once and the native layer adds only what the platform cannot do in a browser. The sovereign platform ships that shell and the tooling to build and release it, so that an institution's team can produce signed desktop and mobile builds against their own deployment without becoming a mobile development shop.

Shared components, not shared screenshots

The temptation, when building for many surfaces, is to build many applications that look alike. The sovereign requirement is stronger: they must be the same components.

The chat interface, the agent picker, the memory panel, the voice controls, the embed widget, and above all the sign-in flow, exist once as a library, and every surface mounts them. When the memory panel gains a feature, every surface gains it. When a security fix lands in the sign-in flow, it lands everywhere at once. And when an institution builds an application of its own, the subject of Chapter 16, it mounts the same components and inherits the same behaviour.

This is a property a CIO can check in a demo. Ask to see the same feature on the web and in the desktop application. If they differ in anything but the window around them, there are two codebases, and the institution will be living with their divergence for years.

The cost of the alternative

An institution that adopts a web-only AI platform pays three costs that do not appear on the invoice.

It pays in adoption, because the platform is one more tab, and tabs lose to the tools people already have open.

It pays in reach, because an agent that cannot see the page the person is working on, or the file on their desk, has to be told everything, and most people will not tell it.

And it pays in governance, because when the web application turns out to be insufficient, departments buy or build their own clients against whatever API they can find, each with its own sign-in, its own credential and its own idea of what the user may see. The next chapter is about the identity layer that makes the alternative, many clients on one governed backend, safe to build.

Run the stack this book describes

ibl.ai is the agent operating system you run yourself: you own all the code and the data, in your cloud, on-premise or air-gapped, with any model, one identity across web, browser, desktop, mobile and terminal, and no per-seat pricing.