Skip to main content
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 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 to view and manage existing spaces
  • CLI — use friday workspace list, friday workspace add, and friday workspace remove
  • API — use the Spaces API endpoints 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.

​
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.