The first World UI (WUI) framework.
A World for the AI Agent you already use: not a chat box, a place your Agent works in.
Worldlet gives OpenClaw, Hermes Agent, Claude Code, Codex or pi a place to work that you can see. The World is operated by AI; you watch and decide.
Worldlet provides no model of its own. It talks through your Agent and borrows its sign-ins, connections, skills and memory, and gives the Agent World tools over the worldlet MCP server. Switch Agents and your World stays.
| Computer | AI era | Who owns it |
|---|---|---|
| CPU | Model | Your model provider (your own sign-in or API key) |
| Kernel | Harness: Hermes Agent, OpenClaw, Claude Code, Codex, pi | Your choice, replaceable |
| Drivers and keychain | MCP servers, connectors and their tokens | Your Harness; Worldlet borrows them |
| Terminal | Chat apps and command lines | Where Agents live today |
| Graphical system | Worldlet: World, Applets, Fox, Attention Center | This project |
| System API | World tools, served to the Agent over the worldlet MCP server |
This project |
| Disk | world.sqlite and World storage, on your computer |
This project |
Worldlet on your own Harness is a desktop environment, like GNOME; with the Hermes Agent it installs, it is a distribution, like Ubuntu. World → Agent tools go over MCP; Agent → World goes through one adapter per Harness (Harness contract, interactive architecture diagram).
macOS
curl -fsSL https://worldlet.ai/install.sh | shWindows (PowerShell)
irm https://worldlet.ai/install.ps1 | iexThe installer downloads the newest release, checks its SHA-256 (and the app's signature on Mac), installs it and opens it. To connect a particular Agent without being asked, name it: openclaw, hermes, pi, claude-code or codex.
curl -fsSL https://worldlet.ai/install.sh | sh -s -- --agent openclaw& ([scriptblock]::Create((irm https://worldlet.ai/install.ps1))) -Agent hermesPrefer a regular installer? Download from worldlet.ai or take one from GitHub Releases. An Agent can install Worldlet for you with the worldlet skill. Details: one-line installers.
No account is needed. If you have no Agent yet, setup installs the standard Hermes Agent the official way, to its usual location; one you already have is used as it is.
|
What needs you, in one place: meetings coming up, things worth doing and news worth knowing, found in your mail, calendar and the services your Agent already reaches. Each item says why it is there. |
|
|
Fox is the companion you talk to, by text or voice. It does the work through your Agent and lays the result out for you: here, a tennis booking with the court, the weather and the invitation ready. Nothing is sent, paid or deleted until you confirm. |
|
|
Mail, Calendar, Notes, GitHub, Notion, Linear and the other Applets that connect your accounts or read this computer, plus the Browser and games, each a small place in the World. An Applet shows your own records in a calm, readable view, and the real website when you want it. |
|
Also in the box:
- Phone companions: the Attention Center and Fox on iPhone and Android, paired by QR code through an end-to-end encrypted relay.
- Journal: the cards Fox makes are kept, day by day.
- Routines: ask once ("every morning at 8, tell me the weather and my first meeting") and Fox keeps doing it; your Agent's scheduled jobs come along. Two come with every install, on unless you turn them off: Today’s prep at 7 AM and Wrap up today at 6 PM, each one Attention card.
- Your Agent on another computer: pair with the always-on machine where your Agent runs, and talk to it from this World.
- Local first: your records stay in
world.sqliteon your computer.
There is no Worldlet account, and your records stay on your computer. Official builds report basic usage analytics (setup, connection and core-operation outcomes, never message content, connected content or browsing history), and you can turn them off in Settings › General › Usage counts; see analytics. Builds you make yourself report nothing unless you configure a PostHog project.
Requirements: Node.js 22.19 or later.
npm ci
npm run dev # development build with a watcher
npm run build # build the interface and the Electron host once
npm run package # package the desktop app for this OS (unsigned)No account, secret or hosted service is needed to build. Checks: npm run check:pr (types, architecture and contract boundaries, docs, source layout, style) and npm test.
| Directory | Responsibility |
|---|---|
ui/ |
Shared rendering and interaction: World, Applets, Fox, Attention Center |
core/ |
Platform-independent product rules and data |
platform/ |
The Electron host: OS integration, browser engine, controlled execution |
harness/ |
Agent backends and the reference Harness adapter |
contracts/ |
Shared Host/Agent interfaces and data shapes |
resources/ |
Worlds, styles, artwork, fonts and media |
ios/, android/ |
Phone companions |
scripts/, docs/ |
Build, validation and contributor guidance |
Worldlet has one theme, the Village. A theme is static pictures, sounds and JSON (Theme contract); Worldlet draws the animated World from it. There is no theme picker.
| Start here | |
|---|---|
| Using Worldlet, how it works, building Applets, releasing | Documentation index (with the complete inventory) |
| Product principles | Charter |
| Architecture | Five layers · Harness contract |
| Contributing | Contributing · development workflow |
- Bugs and ideas: open an issue.
- Security: see SECURITY.md; please do not file security problems as public issues.
- Show support: star this repository to follow along.
Worldlet is free and open source under the Apache License 2.0. Third-party notices: NOTICE.