Slash Commands

The /alice slash command is the primary way to interact with alice from Slack. Every skill you create registers as a subcommand, and a set of built-in commands help you navigate and discover what is available.

Command Syntax

The general format for running a skill:

/alice <skill-name> [--param=value] [--flag]

Examples:

/alice mrr
/alice churn-risk --days=60
/alice signups --since=monday --region=us
/alice failed-payments --limit=20 --channel

Skill names use lowercase with hyphens. Parameters are passed as --key=value pairs. Boolean flags (like --channel) do not require a value.

Built-in Commands

These commands are always available regardless of what skills you have created:

The Skill Picker Modal

Typing /alice with no arguments opens an interactive modal in Slack. The modal provides:

• A dropdown of all skills available in your workspace
• Dynamic parameter inputs that change based on the selected skill -- date pickers for date parameters, checkboxes for booleans, text fields for strings, and dropdowns for enum values
• A Run button to execute the skill with the selected parameters

This is useful when you want to explore available skills visually or when a skill has many parameters that are easier to fill in a form than to type as flags.

The Help Command

Running /alice help returns a formatted list of every skill in your workspace:

Available skills:

  mrr              Monthly recurring revenue breakdown
  churn-risk       Accounts at risk of churning
  signups          Recent signups with plan details
  failed-payments  Failed payment attempts
  active-trials    Currently trialing accounts

Type /alice <skill> --help for details on any skill.

Skill-Specific Help

Running --help on a specific skill shows its full details:

/alice churn-risk --help

churn-risk — Accounts at risk of churning
Source: Stripe + Supabase (combined)

Parameters:
  --days     Number of days to look back (default: 30)
  --limit    Max results to return (default: 10)
  --plan     Filter by plan name (optional)

Example:
  /alice churn-risk --days=60 --limit=5

Parameter Flags

Parameters are defined when you create a skill. Each parameter has a name, type, and optional default value. When running the skill from Slack, pass parameters as flags:

Parameter Types

Default Values

If a parameter has a default value defined in the skill configuration, you can omit the flag entirely. The default is used automatically. Required parameters without defaults must be provided -- alice will return an error message indicating which parameters are missing.

Parameter Validation

alice validates parameter types before executing the skill. If you pass --days=abc for a number parameter, you will see an error like:

Parameter "days" expects a number, got "abc"

Running Skills

When you run a skill, the following sequence occurs:

1. Immediate acknowledgment -- Slack receives a 200 response within 3 seconds, showing a "Running..." message
2. Async execution -- alice queries your connected data sources, joining results if it is a combined query
3. Result delivery -- The "Running..." message is replaced with the formatted result, including any action buttons

Result Footer

Every skill result includes a footer with execution metadata:

Ran by @sarah · 342ms · Showing 10 of 47

The footer shows:

• Who ran it -- the Slack user who triggered the command
• Execution time -- how long the query took in milliseconds
• Result count -- if results are truncated (e.g., "Showing 10 of 47"), the full count is displayed
• Cache indicator -- if results are served from cache, shows "Cached 2m ago"

Truncated Results

When a skill returns more rows than can fit in a single Slack message, results are truncated and the footer indicates the total count. Adjust the --limit parameter to control how many results are returned, or view the full result set in the dashboard logs.

Global Flags

These flags work with any skill:

The --channel flag changes the response type for that single execution. It does not change the skill's default response type.

Command Examples

Basic Queries

/alice mrr
/alice active-subscriptions
/alice customer-count

With Parameters

/alice signups --days=7
/alice revenue --period=quarterly --year=2026
/alice users --plan=pro --status=active

Combined Queries

/alice churn-risk --days=30
/alice expansion-ready --threshold=80
/alice vip-users --revenue=500

Sharing Results

/alice mrr --channel
/alice weekly-summary --channel

Permissions and Access

Slash command access is controlled at the skill level and the workspace level:

Workspace Access

Every member of your alice workspace can run /alice commands. Workspace membership is determined by your Slack workspace membership -- anyone from the same Slack workspace who signs into alice is automatically a member.

Skill-Level Permissions

Individual skills can be restricted to specific access levels:

Configure skill permissions in the skill builder or by editing the skill in Dashboard > Skills > [Skill] > Edit.

Channel Restrictions

Skills can optionally be restricted to specific Slack channels. If a channel restriction is set, running the skill from an unauthorized channel returns an error.

Error Handling

When something goes wrong, alice returns clear error messages:

Next Steps

• Action Buttons -- Interact with results using one-click actions
• Response Types -- Control ephemeral vs in-channel delivery
• Parameters -- Define dynamic inputs for your skills
• Create a Skill -- Build a new slash command
• Limits & Rate Limits -- Understand query quotas