Getting Started

Overview

This guide walks you through creating your first Space, connecting integrations, and running your first Smart Action. By the end, you'll have an AI agent that understands your tools and can automate workflows across them.

Prerequisites

• A Moonage account (sign up at moonage.ai/waitlist)
• At least one connected tool (Notion, Slack, Linear, GitHub, or Google Drive)
• A web browser — no CLI or SDK required to get started

Step 1: Create a Space

A Space is your agent's home. It holds context, integrations, conversation history, and Smart Actions.

1. Navigate to app.moonage.ai
2. Click New Space
3. Give it a name and optional description
4. Choose a persona template or start blank

Space settings

Persona templates

Moonage ships with several built-in personas:

• General Assistant — balanced for most tasks
• Engineering Lead — optimized for code review, issue triage, and technical writing
• Product Manager — great at summarizing feedback, writing specs, and tracking OKRs
• Custom — define your own instructions, tone, and tool access

Step 2: Connect integrations

Spaces become powerful when connected to your tools. Each integration uses OAuth 2.0 — no API keys to manage.

1. Open Space Settings > Integrations
2. Click Connect next to the integration you want
3. Authorize via OAuth
4. The agent will start indexing your data

Supported integrations

What gets indexed?

When you connect an integration, Moonage indexes:

• Notion: Pages, databases, properties, relations, and rollups
• Slack: Messages, threads, channels (public and private you have access to)
• GitHub: Issues, pull requests, repositories, commits, and code files
• Linear: Issues, projects, cycles, and labels
• Google Drive: Documents, spreadsheets (read-only), and file metadata

The index refreshes automatically. You can also trigger a manual re-sync from Space Settings.

Step 3: Run a Smart Action

Smart Actions are multi-step workflows your agent executes across integrations.

Try it out

Ask your agent:

Summarize all open issues in Linear and post a digest to Slack.

The agent will:

1. Query your Linear integration for open issues
2. Group and summarize them by project
3. Format a Slack message with sections and bullet points
4. Post it to the configured Slack channel

How execution works

Smart Actions use a DAG (Directed Acyclic Graph) execution model:

[Fetch Linear Issues] ──┐
                         ├──→ [Summarize] ──→ [Post to Slack]
[Fetch Slack Channel] ──┘

Independent steps run in parallel — the agent fetches Linear issues and resolves the Slack channel simultaneously, then summarizes and posts once both are ready.

Monitoring execution

While a Smart Action runs, you'll see:

• Progress events — real-time SSE stream showing each step
• Tool calls — which integrations are being queried
• Timing — duration for each step and total elapsed time
• Results — structured output for each completed step

Step 4: Configure schedules

Automate recurring workflows with the schedule builder.

1. Open Space > Schedules
2. Click New Schedule
3. Define the trigger (cron expression or natural language like "every Monday at 9am")
4. Write the action prompt
5. Set the output destination (Slack channel, Notion page, etc.)

Example schedules

Next steps

• Learn about Spaces and context in depth
• Explore available integrations and their capabilities
• Build programmatic workflows with the API