> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hellofriday.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Spaces

> Top-level containers for your agents, jobs, and signals — driven by workspace.yml.

Spaces are the top-level container in Friday. Each space represents a complete configuration of agents, jobs, and signals — all defined in a single `workspace.yml` file.

## What is in a space

A space contains:

* **Agents** — the built-in, custom Python, or inline <Tooltip tip="Large Language Model">LLM</Tooltip> agents available for jobs to use
* **Jobs** — the FSM workflows that orchestrate agents step by step
* **Signals** — the triggers that start jobs (HTTP webhooks and manual API calls, cron schedules, filesystem events, and chat platforms like Slack, Discord, Telegram, and WhatsApp)
* **Skills** — structured instruction sets attached to agents for consistent output
* **Memory** — persistent state across sessions, automatically injected into agent context
* **MCP tools** — external tool servers (GitHub, Postgres, Notion, etc.) agents can call
* **Configuration** — environment variables, credentials, and settings

## workspace.yml

Everything in a space is driven by a `workspace.yml` file. This makes your configuration versionable, shareable, and repeatable. You can check it into source control, share it with teammates, or use it as a template for new spaces.

## Managing spaces

* **Studio** — drag and drop a `workspace.yml` to add a space, or use the [space dashboard](/guides/friday-studio) to view and manage existing spaces
* **CLI** — use `friday workspace list`, `friday workspace add`, and `friday workspace remove`
* **API** — use the [Spaces API endpoints](/api-reference/introduction) to manage spaces programmatically
* **Bundles** — pack a single space (or your whole instance) as a portable zip and re-import it on another machine. Bundles carry runtime data and, optionally, narrative memory — see [Backup and restore](/guides/friday-studio#backup-and-restore).

## Starter spaces

Friday ships with starter spaces you can browse and import from **Discover Spaces** in the Studio. Each one is a working example you can customize.