docs / start

Introduction

Mod is a computing environment built for agents that work beside you as equals, in the same documents, code and machines as your whole team.

It is a place to build in, and to build together. Your code, documents and agent sessions live in one shared place, synced to every machine. Anything you build on it, from a tool to an app to an agent, is multiplayer and live from the start, because it is made of the same parts as Mod.

Shared hands

Agents work in the same documents, designs, code and machines you do, with the same tools. Watch any of it live, and take over by hand at any moment.

documents · sources · tools · agent interface

Multiplayer by default

Your whole team and its agents work in one place and see each other's work as it happens. Every change names who made it, person or agent.

projects · sessions · tasks · comments · identity

Malleable

Agents get the building blocks Mod itself is made of: records, apps, tools and skills. What they build works the way Mod does: shared, multiplayer and live.

apps · tools · packages · skills

At any scale

Thousands of agents work alongside your team around the clock, on your Mac, your own servers or Mod's pool, each in its own VM and with only the access you grant it.

workers · local · servers · pool · vms

How Mod works

Every computer is built from three things: compute, storage and networking. Mod keeps them apart, and puts agents at the centre. An agent's work is kept in storage, shared state that every device holds a copy of. It runs on compute, any machine that can pick it up. Networking moves state between them all, and access decides what each person and agent may touch. The interface you work in, and the packages that extend it, sit on top.

Component	What it does
Agentssessions harnesses models awareness vision voice hands	The agent and its work. A session is one piece of work and its log, a harness drives it and a model thinks for it. It is aware of what others are doing, sees, hears and speaks, and acts with its own hands.
Interfaceapps layouts thread spaces	Apps are views over shared records, and agents change, see and operate them through the same rules as you. Layouts and spaces arrange what you are looking at, and a thread is where you and an agent talk.
Storageworld projects documents shared data types sources history branches	Shared state, kept apart from compute. Not one big filesystem: many small documents, each with its own history, grouped into the projects you share. Every device holds a copy and writes to it at local speed.
Computeworkers local your servers pool vms	The machines work runs on: your Mac, your own servers, or a pool that picks up sessions while your devices are away, each running sessions in their own VMs. Where a session runs is never part of its address.
Networkingsync relay peers	How state moves between every device, VM and person, with no locks: a relay that is always on, and peers that sync with it and each other.
Accessidentity authentication authorisation encryption connectors secrets	Who did what, and who may do what. People, agents and devices each have an identity and only the access they are granted, everything is encrypted end to end to the people in it, connectors reach outside services with your own sign-in, and secrets stay in your device's keychain, never in what syncs.
Extendingpackages tools skills	What you add: packages with apps and data types, tools that let agents act on more, and skills that tell them what they should know.

nextSessions