Skip to main content
MeshAgent Studio is the browser-based workspace for building, testing, and operating MeshAgent projects. With MeshAgent Studio you can:

​
Project selector and account menu

MeshAgent Studio opens to an active project. Use the dropdown in the upper-left corner to switch between projects you belong to or create a new one. Use the menu in the upper-right corner to sign out. Admins may also see an Account management entry that opens MeshAgent Accounts.

​
Project navigation

The main project sidebar depends on your project role: Some project pages are opened contextually instead of living in the permanent sidebar. For example, Studio links to Billing when a project is out of credits or after checkout flows.

​
Rooms

Use rooms to isolate agent runtime environments. Rooms are secure environments where humans and agents can collaborate and share context. Rooms can have their own services, scheduled tasks, routes, and mailboxes. From the MeshAgent Studio UI you can:
  • Create a room with New Room
  • Toggle between My Rooms and All Rooms. All Rooms is available to developers and admins.
  • Open a room from the list to enter its workspace.
  • Use the room menu to open Edit, Services, Scheduled Tasks, Mailboxes, Routes, Permissions, or Delete.

​
Sessions

Monitor and debug live and recent room sessions. A session starts when a room starts and stops when the room stops. For the API and data model behind what you see here, see Sessions. From the Sessions page you can:
  • Create a session with New Session
  • Toggle between Active Sessions and Recent Sessions
  • Open a session to inspect Logs, Traces, and Metrics
  • Stop an active session from the row menu

​
Room Workspace (inside a Room)

From both Rooms and Sessions you can open the Room Workspace. This is where you develop, test, and debug agents and tools. Opening a room starts or joins a live session. Room-scoped services remain available to the room beyond any single session.

​
Layout

  • File Browser (left): Browse room files. Depending on your permissions, you can create folders and text files, upload and download files, and remove files.
  • File Previews (center): Open documents, code, tables, markdown notes, memory viewers, and other room resources in tabs.
  • Messaging (right): Chat with human and agent participants in the room.
  • Developer Console (bottom): Live debugging tabs for Logs, Traces, Metrics, Images, Containers, Services, and Terminal.
The container-related tabs serve different jobs:
  • Images shows images already pulled or built for the room runtime.
  • Containers shows running and stopped room containers, along with logs and runtime actions.

​
Room Menu (upper left)

  • Leave Room: Exit the room and return to the project view
  • Call Agent: Invoke a room-connected agent directly
  • Toolkits: View available tools and toolkits in the room and invoke them directly
  • Queues: View room queues and the number of messages in each queue
  • Database: Open the room database and work with tables
  • Memory: Open room memory viewers
  • Room Services: View, add, remove, and update services tied to this room
  • Scheduled Tasks: Manage tasks that enqueue work on a schedule
  • Mailboxes: Manage mailboxes that route into this room
  • Routes: Manage domains and ports that route into this room
  • Keychain: Review and manage room keychain entries
  • View Toggles: Show/hide File Browser, File Previews, Messaging, and Developer Console

​
API Keys

Issue and rotate project-scoped credentials used by automations, CI, and services that call MeshAgent APIs. See API Keys for the full reference. You can:
  • Create, relabel, and revoke keys
  • Track when a key was created for audit and rotation

​
System Services

Services turn your agents, toolkits, or connectors into reusable building blocks. Project-wide services are managed from the System Services page. Room-scoped services are managed on the room itself, either from the room list or from inside the Room Workspace. For deployment flows and service packaging, see Service YAML. From System Services you can:
  • Inspect what’s deployed to the project
  • Create, update, or remove deployed services
  • Change the Room Server Version if you need to pin a project to a specific version of MeshAgent or return to latest

​
Project Secrets

Store configuration securely. Use Secret Keys for app/runtime config and Image Pull Secrets for private registries. See Secrets Overview for how these secret types fit together.
  • Create a secret with key/value pairs
  • Add image pull secrets to fetch private images
  • Remove secrets that are no longer needed.

​
Webhooks

Webhooks notify your systems when something interesting happens inside MeshAgent. See Webhooks for setup details and signature verification guidance.
  • Subscribe to events such as room.started and room.ended
  • Configure the name, URL, and select event triggers.

​
Integrations

Bring your own model routing and observability settings. See Integrations for the full configuration reference: LLM provider settings
  • Use MeshAgent-managed routing by default, or configure your own provider credentials and base URLs for providers such as OpenAI and Anthropic.
  • Services, coding agents, and compatible SDK clients can use MeshAgent LLM Proxy to route requests through those project settings.
Telemetry (OTEL)
  • Export room/runtime metrics and traces by providing an OTEL endpoint and optional bearer token.
  • Optionally configure an OTEL filter endpoint before MeshAgent processes and forwards telemetry.

​
LLM Proxy

Open LLM Proxy from the project navigation when you want the project’s provider-compatible base URLs or want to inspect routed usage for your own account. From this page you can:
  • open the About tab to copy the OpenAI-compatible and Anthropic-compatible base URLs
  • open the My Usage tab to inspect your routed LLM usage for the current project
  • open the main LLM Proxy docs from the built-in Read docs link

​
OAuth

Create OAuth2/OIDC clients to enable MeshAgent to sign in for your apps. A client is used to identify a single app to MeshAgent’s OAuth servers. See OAuth Clients for the full setup flow.
  • Register a client with redirect URIs, scopes, grant types, and response types.
  • Create, edit, and delete clients from the project.

​
Routes

Use Routes to map project or room traffic to the right room. See Routes for the full route model and setup details. From this page you can create, edit, refresh, and delete routes, including the domain and port that should route into a room.

​
Scheduled Tasks

Use Scheduled Tasks to enqueue work on a schedule. See Scheduled Tasks for the full behavior and examples. You can create tasks at the project or room level, edit schedules, toggle tasks on or off, and delete tasks that are no longer needed.

​
Mailboxes

Provision room-scoped mailboxes that agents can read from or send through. See Mailboxes for the full setup flow:
  • Create mailboxes and assign them to rooms
  • Map incoming mail to queues so worker agents can process it asynchronously
  • Edit or delete mailboxes when your routing changes

​
Billing

Billing is available through direct Studio flows when a project needs attention, but the underlying billing surface lives in MeshAgent Accounts. From the billing page you can:
  • View current credit balance and spend
  • Purchase credits
  • Configure automatic recharge

​
Next Steps

  • Follow the Quickstart to create your first project, room, and agent from the CLI.
  • When you are ready for production, read Service YAML to write and deploy service manifests.