desktop environment, OS, pain in the ass to work on
  • Rust 88.9%
  • Python 5.3%
  • Shell 1.8%
  • JavaScript 1.6%
  • Fluent 1.2%
  • Other 1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
qwolff 454df0a280
Some checks failed
CI / fast quality / policy (push) Has started running
CI / fast quality / lints (push) Has started running
CI / affected packages / supersede (push) Successful in 33s
CI / affected packages / builder (push) Has been skipped
CI / affected packages / select (push) Has been skipped
CI / affected packages / security-fixtures (push) Has been skipped
CI / affected packages / suites (push) Has been skipped
CI / affected packages / android (push) Has been skipped
CI / affected packages / wasm (push) Has been skipped
CI / affected packages / vendored (push) Has been skipped
CI / affected packages / pins (push) Has been skipped
CI / affected packages / security (push) Has been skipped
CI / affected packages / web (push) Successful in 4m10s
CI / affected packages / checks (push) Has been skipped
CI / affected packages / untested (push) Has been cancelled
feat(tilolang): run standalone windows and captures on an in-process host
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 03:55:28 -08:00
.cargo feat(dev): cargo desktop, cargo headless and cargo web run Tilo from a checkout 2026-11-12 14:19:26 -08:00
.codex codex hooks: fixtures named after what they carry 2026-10-27 13:57:26 -07:00
.config feat(session): a drag crosses to the person's device beside this one 2026-11-13 16:34:26 -08:00
.cursor feat(agent-loop): an isolated session for testing an app's agent experience 2026-10-02 11:53:07 -07:00
.forgejo refactor(collab): name the workspace key crates and types for what they hold 2026-11-13 21:01:09 -08:00
.githooks fix(policy): a type a compact format carries writes every field 2026-11-13 12:12:54 -08:00
.github feat(sdk): license the app framework as MIT and document contributions 2026-10-24 16:10:13 -07:00
apps feat(tilolang): run standalone windows and captures on an in-process host 2026-11-14 03:55:28 -08:00
crates feat(tilolang): run standalone windows and captures on an in-process host 2026-11-14 03:55:28 -08:00
dist Merge commit '3520b82bf0': main's commits since the last merge of main 2026-11-13 08:56:49 +01:00
docs feat(session): let agents from the person's other devices act without asking 2026-11-14 02:26:07 -08:00
examples refactor(collab): delete GovernedMember and the relay's WorkspaceMember 2026-11-13 20:58:39 -08:00
fuzz chore(deps): drop the dependencies nothing uses any more 2026-10-22 22:18:54 +02:00
keys docs: remove the remaining mentions of the t tool 2026-10-29 18:20:03 -07:00
os test(tilo-sh): drop onto an empty desk as onto a gap in the strip 2026-11-14 03:40:37 -08:00
scripts refactor(desktop-model): delete WorkspaceSlot 2026-11-14 02:58:23 -08:00
sdk refactor(chat): keep the acting tree on a message and name agents from their member row 2026-11-14 03:01:09 -08:00
shots docs: replace the doc sprawl with a small accurate set 2026-10-29 18:20:03 -07:00
tools feat(tilolang): run standalone windows and captures on an in-process host 2026-11-14 03:55:28 -08:00
vendor perf(history): read each change from the document, not a second copy 2026-11-13 23:54:44 -08:00
.containerignore chore: rename qOS to Tilo 2026-09-17 02:52:26 +00:00
.gitattributes ci: remove the unused t tool's config, checks and docs 2026-10-29 18:20:03 -07:00
.gitignore docs: replace the doc sprawl with a small accurate set 2026-10-29 18:20:03 -07:00
AGENTS.md chore(test): run tests through t instead of a second local driver 2026-11-12 19:07:01 -08:00
Cargo.lock feat(tilolang-host): tell hosted windows what the person may do 2026-11-14 03:52:26 -08:00
Cargo.toml perf(tilo-sh): take the local stack's programs and bundle from t's checks 2026-11-14 01:50:19 -08:00
clippy.toml feat(ui): every widget draws its children through a keyed path 2026-11-11 02:52:24 -08:00
CONTRIBUTING.md fix(dev): the push gate compiles with any cargo drop-in 2026-11-13 11:06:01 -08:00
deny.toml refactor(collab): name the workspace key crates and types for what they hold 2026-11-13 21:01:09 -08:00
flake.lock build: package desktop session across Linux distros 2026-09-01 01:16:10 +02:00
flake.nix Expose Cargo vendor validation as Nix check 2026-09-30 11:05:18 +02:00
LICENSE chore: add AGPL-3.0 licence 2026-08-26 14:53:40 +02:00
LICENSE-MIT feat(sdk): license the app framework as MIT and document contributions 2026-10-24 16:10:13 -07:00
LICENSING.md feat(licensing): the app language's lexer is MIT, beside an AGPL compiler 2026-11-10 19:00:06 -08:00
README.md feat(dev): cargo desktop, cargo headless and cargo web run Tilo from a checkout 2026-11-12 14:19:26 -08:00
rust-toolchain.toml fix(web): tilo-ui builds for the web again 2026-10-28 00:05:21 -07:00
SECURITY.md chore: name tilo.sh as the Tilo app's site, in place of tilo.coffee 2026-11-08 17:49:03 -08:00
t.toml ci(t): build a shared library as one unit for every family that tests it 2026-11-14 02:55:18 -08:00

Tilo — a desktop for doing things together.

Website · Contribute · Build an app · Source & issues

Tilo is a Linux desktop built around collaboration and around working across your own devices. You share a workspace with someone and work together in every Tilo app, with full history, undo, search and sync between devices and people. You can add AI agents too, with their own permissions and history.

We build the desktop, the apps and the system underneath them together. Tilo is early alpha: expect things to break, and don't trust it with your only copy of important data.

How it works

  • Workspaces are the unit of collaboration. Each has its own members, roles, apps, layout and data, and is on every device of every member.
  • People and devices are separate. A member is an identity; each of their devices has its own key. Devices sync directly over iroh, end to end encrypted with MLS. A server is just a device that stores more.
  • All shared state is CRDT. Edits from several people and devices merge.
  • Apps are resources, actions and views. An app declares its typed state and the actions that change it; collaboration, history and undo, permissions, sync and search come from that. Scripts, assistive technology and agents use the same actions as the buttons.
  • The shell is built like an app. Launcher, top bar and settings run on the same toolkit and model as every other app. Windows sit in horizontally scrolling strips; tabs can group different apps.

The architecture overview explains the model and where it lives in the code; workspace.md is the full specification. The apps directory lists the apps.

Try it

There is no public release download yet. Getting started covers virtual machines, adding the desktop to an existing Linux system and installing the OS. From a checkout, one command runs it:

cargo desktop     # the desktop in a window on your desktop
cargo headless    # the session with no window, for agents and tests
cargo web         # the web desktop on the local hosting stack

CONTRIBUTING.md says what each needs and does.

Help build it

You don't need to understand the whole system to help, or even to program: bug reports, small fixes, accessibility testing, translations, documentation and design feedback all count. CONTRIBUTING.md takes you from a checkout to a pull request; Build an app covers the app SDK.

Our home is code.tilo.so/tilo/tilo. GitHub is a mirror; please send issues and pull requests to Forgejo. People and coding agents are both welcome; if you use an agent, understand the change you submit and say what you tested. AGENTS.md is for the agent.

License and security

Tilo is open source: everything you need to publish an app is MIT, the rest is AGPL 3.0. See LICENSING.md.

Please report vulnerabilities privately as described in SECURITY.md, not in a public issue.