Platform Documentation
Platform Documentation
Breadcrumbs

Workspaces

A Workspace is the tenancy boundary in RunWhen. Everything you work with — AI assistants, tasks, rules, commands, secrets, and SLXs — lives inside a workspace.

A workspace typically maps to a team or environment boundary. Common examples:

  • A single product team and its services

  • A platform or SRE team spanning multiple clusters

  • A shared demo or sandbox environment

  • An individual developer’s test environment

The RunWhen UI organizes each workspace into three main sections, accessible from the left sidebar:

sidebar-full.png

Section

What It Contains

Workspace Chat

The primary interface. Ask questions in natural language and an AI assistant investigates your environment, runs diagnostic tasks, and returns findings. Suggestion chips at the bottom provide quick-start prompts.

Workspace Studio

Where you configure and manage operational automation:
Tasks — browse and run diagnostic or remediation tasks
Rules — define how assistants behave (e.g., ignore known noise, prioritize certain issues)
Commands — reusable multi-step procedures an assistant can execute on request
Knowledge — additional context documents the assistant can reference
Workflows — notification and integration pipelines (e.g., Slack alerts)
Assistants — configure the AI assistants available in the workspace

Workspace Configuration

Administrative settings:
Settings — workspace name, display title, runner registration, resource scrubber
Users — manage workspace membership
Secrets — credentials stored securely in HashiCorp Vault

Workspace Chat

When you open a workspace you land on Workspace Chat. The interface shows:

  • The workspace name and a summary of how many assistants and tasks are active

  • A chat input where you type questions in plain English

  • The currently selected assistant (e.g., “Dev Danica”)

  • Suggestion chips with common questions about your environment

workspace-chat.png

Switching Workspaces

If you belong to multiple workspaces, click the workspace name in the top-left corner to open the workspace selector. From here you can switch to a different workspace or view all workspaces available to you.

workspace-selector.png

What Lives in a Workspace

All of the following are scoped to (and isolated within) a single workspace:

  • AI Assistants — each with their own personality, permissions, and thresholds

  • Tasks & SLXs — the diagnostic and remediation automation

  • Rules — behavioral guidelines for assistants

  • Commands — reusable multi-step procedures

  • Secrets — credentials for connecting to infrastructure and services

  • Users & RBAC — who can see and do what

  • Workflows — notification and integration pipelines

Data does not cross workspace boundaries. An assistant in one workspace cannot see or act on resources in another.