Skip to main content

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 are where you get work done in Friday — each one is a collection of agents, jobs, and signals focused on a specific task.

​
Create your own

Go to Chat and describe what you want:
“I want a space that monitors my GitHub notifications every morning and sends me a digest of open PRs and reviews waiting on me.”
Friday creates the space, wires up the agents and schedule, and registers it all through conversation. You can keep refining it by chatting. As you define your space in chat, Friday will ask clarifying questions and request login details where appropriate.
Friday authorizes with external services via OAuth or API Keys. Authorization can be revoked at any time.

​
Import an existing Space

Friday comes with starter spaces you can import from the library. Using the Inbox Zero, which triages your Gmail and learns your preferences over time:
1

Open Discover Spaces

In the Studio sidebar, click Discover Spaces. You’ll see the full space library.
2

Import Inbox Zero

Find Inbox Zero and click Add Space. Friday imports it and takes you to its dashboard.
3

Connect Gmail

The space README tells you what to set up. For Inbox Zero: click Connect on the Gmail integration. Sign in with Google and approve access.
4

Follow the README

Each space has a short README with any setup specific to that workflow — usually just connecting an account or filling in your email address. Read it, follow the steps.

​
Upload your own

You can upload a Space’s .zip bundle by clicking the “Plus” icon next to “Spaces” in the Friday Studio sidebar, or by clicking Settings in the sidebar and navigating to “Import a space” under “Backup & restore”

​
Run your Space

Spaces use Signals to trigger Agents and Jobs. If you requested your Space to run on a regular schedule, the signal will run on a regular interval via CRON. You can also manually run a Signal at any time via chat. Let’s use the Inbox Zero example from the “Import an existing Space” above: Go to the Chat tab in your Inbox Zero space and say:
“Review my inbox”
Friday fetches your 10 most recent unread emails and walks you through them one at a time. For each one, you choose what to do — archive, keep, delete, or unsubscribe. Friday acts on your choice immediately. After the first session, it starts remembering your patterns. Run it again and it surfaces suggested actions based on what you’ve done before. Enable the autopilot job and it runs every morning at 8am, handles the high-confidence calls itself, and flags anything it’s unsure about.
Every Space in the library works this way — import, connect, run. The README tells you exactly what each one needs.

​
Review configuration

Every Space can be viewed as a single workspace.yml file where you can read, edit, and update its version. Whether created via chat or imported, the underlying config looks like this:
workspace.yml
version: "1.0"
workspace:
  name: My Workflow
  description: What this space does

signals:
  run-now:
    provider: http
    title: Run now
    description: Trigger manually
    config:
      path: /run-now

agents:
  my-agent:
    type: atlas
    agent: web
    description: Does the thing
    prompt: |
      Describe exactly what you want the agent to do.

jobs:
  my-job:
    title: My Job
    description: What this job does
    triggers:
      - signal: run-now
    fsm:
      initial: idle
      states:
        idle:
          on:
            run-now:
              target: run
        run:
          entry:
            - type: agent
              agentId: my-agent
            - type: emit
              event: DONE
          on:
            DONE:
              target: done
        done:
          type: final
Space configs are accessible by going to Overview under you Space in the Friday Studio sidebar and clicking “Edit Configuration” in the top right corner of the screen

​
What’s next

Space Examples

9 ready-made spaces covering email, GitHub, Telegram, Google Sheets, price monitoring, and more.

Communicators

Connect a Communictor and chat with your Space on the go.