Quickstart

This guide walks you through setting up alice and running your first query from Slack. By the end, you will have a working slash command that pulls live data from your connected sources and displays it in a Slack message.

Prerequisites

Before starting, make sure you have:

• A Slack workspace where you have permission to install apps. You need to be a workspace admin or have the "install apps" permission enabled for your role.
• A Stripe account and/or a Supabase project with data in it. alice connects to these via OAuth, so you need login access to at least one.
• A modern browser. alice's dashboard works in Chrome, Firefox, Safari, and Edge.

You do not need to create a separate alice account. Authentication is handled entirely through Slack OAuth.

Step 1: Sign in with Slack

Navigate to app.alicehasnoidea.com and click Continue with Slack.

alice uses Slack's OpenID Connect flow to authenticate you. After authorizing, alice reads your workspace ID (team_id) from your Slack identity and uses it to determine your organization:

• First person from a workspace -- alice creates a new organization using your Slack workspace name and assigns you as the owner.
• Second or subsequent person -- alice detects that an organization already exists for your team_id and automatically adds you as a member. No invite link needed.

This means your entire Slack workspace can access alice without any invite flow. See Members and Roles for details on the owner, admin, and member roles.

Step 2: Install the Slack bot

After signing in for the first time, alice takes you through a guided onboarding flow. The first screen asks you to install the alice Slack bot into your workspace.

Click Add to Slack and authorize the requested permissions. The bot needs access to:

• Slash commands -- so you can use /alice in any channel
• Post messages -- so scheduled reports and alerts can be delivered to channels
• Read workspace members -- so alice can manage per-user permissions

After authorization, you are redirected back to alice and the onboarding continues to source connection.

You can skip this step and install the bot later from Settings > Workspace, but most features (slash commands, scheduled reports, monitors, action buttons) require the Slack bot to be installed.

Step 3: Connect a data source

Connect at least one data source. alice currently supports two sources, both connected via OAuth:

Stripe

Click Connect next to Stripe. You will be redirected to Stripe's OAuth authorization screen. Authorize access and you will be returned to alice with your Stripe account connected. alice reads your customers, subscriptions, invoices, and payment data using Stripe's API.

Supabase

Click Connect next to Supabase. After authorizing, alice loads your Supabase projects and shows you a picker. Select the project you want to query. alice reads your database schema (table names, column types, row counts) to understand what data is available.

If you connect both sources, you unlock combined queries -- the ability to join Stripe revenue data with Supabase application data in a single skill. For example, identifying customers with failed payments who also have not logged in for 14 days.

Additional sources (PostHog, Linear, Crisp, HubSpot, and more) are coming soon. You can add or change sources anytime from Settings > Sources.

Step 4: Create your first skill

After connecting sources, alice runs an AI analysis of your data and suggests up to 6 pre-built skills based on what it discovers. The default suggestions include:

Select the skills you want (the recommended ones are pre-checked) and click Enable. Each selected skill is immediately saved to your workspace and becomes available as a slash command.

If none of the suggestions fit your needs, you can always create skills manually later using the skill builder, templates gallery, or AI generation.

Step 5: Run your first command

Open Slack and type your first command in any channel:

/alice mrr

alice responds within a few seconds with a loading indicator, then updates the message with your formatted results. Here is an example of what the MRR Tracker skill returns:

MRR Report -- February 2026

| Metric       | Value     | Change    |
|-------------|-----------|-----------|
| Current MRR | $34,200   | +8.2%     |
| New MRR     | $4,100    | +12 cust. |
| Expansion   | $1,200    | +3 cust.  |
| Churned     | -$2,100   | -5 cust.  |
| Net new     | $3,200    |           |

Data from Stripe | Updated just now

[Tag at-risk]  [DM account owner]  [Create ticket]

The action buttons at the bottom are available on the Pro plan and above. Clicking one executes a safe, one-click operation like tagging a customer in Stripe or sending a Slack DM. See Actions for the full list.

Passing parameters

Many skills accept parameters to customize the query. Pass them as flags:

/alice signups --days=30
/alice churn-risk --days=60
/alice active-users --plan=pro
/alice failed-payments --limit=20

To see what parameters a skill accepts, add the --help flag:

/alice mrr --help

See Slash Commands for the full command reference and Parameters for how to add custom parameters to your skills.

Built-in commands

alice includes a few built-in commands that do not require creating a skill:

What to do next

You now have alice connected to your data and at least one working slash command. Here are the recommended next steps:

Explore your data further

• Create a Skill -- Walk through the 6-step skill builder to create a custom query
• AI Skill Generation -- Describe what you want in plain English and let AI build the skill
• Skill Templates -- Browse pre-built templates for common Stripe and Supabase queries
• Combined Queries -- Join data across multiple sources in a single skill Pro

Set up automation

• Scheduled Reports -- Deliver skill results to a Slack channel on a cron schedule Pro
• Monitors -- Get alerted when query results cross a threshold Pro

Learn the fundamentals

• Core Concepts -- Understand Skills, Sources, Triggers, Actions, Output Types, and Logs
• Onboarding Walkthrough -- Revisit any onboarding step in detail
• Plans and Limits -- Understand what is available on Free, Pro, and Business

Manage your workspace

• Members and Roles -- Invite teammates and manage permissions
• Billing -- Upgrade to Pro or Business for more skills, sources, and automation
• Security -- Review how alice handles your credentials and data