MeshAgent
MeshAgent is the platform for building, deploying, and operating room-based agent systems. A room is the runtime and collaboration boundary where humans, agents, tools, services, and shared state work together. Instead of treating every agent interaction as an isolated run, MeshAgent gives you a live workspace with built-in infrastructure, deployment surfaces, and product interfaces around that room. If you want commands you can copy and run, start with Quickstart. This page is the short mental model for everything else in the docs. Most agent products give you one part of the stack: model access, a sandbox, an orchestration loop, or a chat surface. MeshAgent gives you the full operating surface for collaborative agent applications: rooms, agents, built-in runtime APIs, deployable services, developer tooling, end-user interfaces, permissions, and observability. If you want agents that can do real work with people, data, documents, queues, mail, tools, and custom code without stitching together your own runtime, that is what MeshAgent is for. Every MeshAgent account includes MeshAgent Accounts, MeshAgent Studio, and Powerboards. They share the same underlying projects and rooms, but each surface is optimized for a different kind of work.Why teams use MeshAgent
- Rooms as the center of the system: Every room has shared context, participants, built-in APIs, and runtime behavior in one place.
- Built-in infrastructure: Storage, database, queues, sync/documents, containers, secrets, messaging, and developer events are already part of the room runtime.
- Agents that can do more than chat: Run agents across chat, mail, queues, toolkit calls, and other room-connected workflows.
- One platform from local testing to production: Use the CLI and MeshAgent Studio to iterate quickly, then deploy the same capabilities as project or room services.
- Developer and end-user surfaces: Developers build and inspect in MeshAgent Studio. End users can work with agents in Powerboards, and both surfaces can reach the same rooms.
- Fast start or full customization: Start with built-in agents in Powerboards or MeshAgent Studio, or bring and build your own agents, tools, and services.
- Governance and observability built in: Control access, scope permissions, inspect logs and traces, and understand usage and cost without bolting on a separate control plane.
What MeshAgent includes
- Rooms with built-in runtime APIs for messaging, storage, database, queues, documents, containers, secrets, and developer events
- Agents that can work across chat, mail, queues, toolkit calls, and other room-connected workflows
- Services you can deploy at the project or room level
- MeshAgent Accounts for project membership, billing, and usage
- MeshAgent Studio for developers and operators
- Powerboards for end users working with agents in rooms
- CLI and SDKs for local development, automation, and custom applications
Core concepts
Project
A project is the top-level container for related work in MeshAgent. Projects group:- rooms
- members and roles
- API keys and credentials
- deployed services
- routes, mailboxes, and scheduled tasks
- billing and other project-level settings
Room
A room is the runtime and collaboration boundary in MeshAgent. It is the place where humans, agents, tools, services, files, queues, and shared documents come together around the same live context. Rooms belong to projects, and each room can have its own participants, room-scoped services, and persisted state. Rooms become active on demand, provision the runtime they need for that session, and shut down automatically when idle. That means they scale with usage rather than staying running all the time.Session
A session is one active run of a room. When a room becomes active, MeshAgent starts a session for that room. During the session, participants connect, services run, and logs, traces, metrics, and events are recorded. When activity stops, the room shuts down automatically.Participant
A participant is anything that joins a room and takes part in the runtime. Participants can be:- humans
- agents
- services
- tools exposed into the room
Agent
An agent is a room-connected participant that receives work, uses tools and room capabilities, and produces results back into the room. Agents can:- answer in chat
- consume queued work
- handle mail
- be invoked by other agents
- run locally during development or be deployed as services
meshagent process.
Tool / Toolkit
A tool is a callable capability an agent can use to take action. A toolkit is a group of related tools exposed together. MeshAgent supports built-in tools, custom tools, MCP-based tools, and toolkit-style agents that can be invoked by other agents.Skills
A skill is reusable guidance that helps an agent handle a class of tasks better. Skills are not callable tools. They are playbooks the agent can discover and apply when relevant. In practice, skills often tell the agent which tools to use, what files to inspect, and how to structure the output.Threads
A thread is the continuity boundary for agent work. Threads let an agent keep related work together without mixing unrelated conversations or jobs into the same history. This is especially important for agents that work across chat, queues, mail, and toolkit calls.Service
A service is how code is packaged and deployed into MeshAgent. Services can package:- agents
- tools and toolkits
- connectors and integrations
- supporting application logic
Project Services and Room Services
A project service is available across the project. A room service is scoped to one room. Use project services for shared capabilities that should be broadly available. Use room services for room-specific or user-specific behavior. Choose that scope when you deploy the service.Room APIs
The Room APIs are the built-in runtime capabilities available inside a room. These include:- messaging
- storage
- database
- queues
- sync/documents
- containers
- secrets
- developer events and logs
Interfaces
An interface is a product surface people use to work with MeshAgent. Today the main interfaces are:- MeshAgent Accounts for project membership, billing, and usage
- MeshAgent Studio for developers building, testing, deploying, and inspecting
- Powerboards for end users interacting with deployed agents
How the system fits together
- Work starts inside a project.
- People and services create or join a room.
- When the room becomes active, MeshAgent starts a session, provisions the room runtime, and starts the services that should run there.
- Humans and agents use the room’s built-in APIs and shared state to do work together.
- MeshAgent Accounts, MeshAgent Studio, and Powerboards give different kinds of users access to the same underlying projects and rooms.
What MeshAgent lets you build
- custom agents and tools that work with teams over shared context
- customer-facing agents you can ship in Powerboards or your own UI
- document-heavy workflows where agents and people need to read, write, and coordinate over the same data
- multi-agent systems that combine chat, background queues, mail, toolkit calls, and scheduled work
- custom applications where agents need real runtime capabilities, not just prompt wrappers
Where to go next
- Quickstart: install MeshAgent, connect the CLI, run your first agent, and deploy it
- Rooms: explore the room runtime and built-in APIs
- Agents & Tools: learn how agents work in MeshAgent
- Deploy & Manage: package, deploy, observe, and manage services
- Interfaces: see how Studio and Powerboards fit together