Creating an Agent App

There are two ways to create an Agent App:

Developer Portal (in-app UI) — for most developers
Edge Function API (HTTP) — for automation and CI/CD

Via the Developer Portal

Navigate to Developer → Register New App inside the AssistMe app. The registration form collects:

Basic Information

Field	Required	Description
App Name	Yes	Display name shown in the store (e.g., "My Weather App")
Slug	Yes	Unique identifier, auto-generated from name. Lowercase letters, numbers, and hyphens only. Must start and end with a letter or number.
Description	No	Short description shown in store listings
Category	No	One of: `productivity`, `health`, `education`, `social`, `finance`, `lifestyle`, `utility`, `entertainment`. Defaults to `utility`.
Long Description	No	Detailed description shown on the app detail page
Brand Color	No	Hex color for the app icon background. Choose from 8 preset colors. Defaults to `#6366f1` (indigo).
Icon URL	No	Custom icon image URL
Tags	No	Searchable tags for discoverability (array of strings)

Agent Configuration

Field	Default	Description
System Prompt	—	Instructions that define the agent's persona and behavior
Model	Claude Sonnet 4.6	AI model. Options: Claude Sonnet 4.6, Claude Haiku 4.5, Claude Opus 4.6
Temperature	0.7	Creativity level (0 = deterministic, 1 = maximum creativity)
Max Tokens	1024	Maximum response length (1–32,768)
Welcome Message	—	First message displayed when a user opens the app
Suggested Prompts	—	Up to 4 quick-start prompts shown as tappable buttons
Tools	—	Capabilities the agent can use
Memory Enabled	Off	Whether the agent remembers context across sessions
Max Context Messages	50	Number of conversation history messages to include (1–500)

Available Tools

Tool	Description
`web_search`	Search the web for information
`code_exec`	Execute code snippets
`image_gen`	Generate images
`file_read`	Read files
`calculator`	Perform calculations
`calendar`	Access calendar data
`reminders`	Manage reminders
`knowledge_base`	Query a knowledge base

Via the API

Send a POST request to the agent-app-register edge function:

curl -X POST "${SUPABASE_URL}/functions/v1/agent-app-register" \
  -H "Authorization: Bearer ${AUTH_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "my-weather-app",
    "name": "My Weather App",
    "description": "Get personalized weather forecasts",
    "category": "utility",
    "color": "#3b82f6",
    "system_prompt": "You are a weather assistant. Provide accurate, concise weather information.",
    "model": "claude-sonnet-4-6",
    "temperature": 0.5,
    "max_tokens": 2048,
    "tools": ["web_search"],
    "welcome_message": "Hi! Ask me about the weather anywhere in the world.",
    "suggested_prompts": [
      "What is the weather today?",
      "Will it rain this week?",
      "What should I wear tomorrow?"
    ],
    "memory_enabled": false,
    "max_context_messages": 50,
    "tags": ["weather", "forecast"],
    "long_description": "Get detailed weather forecasts for any location worldwide."
  }'

Validation Rules

The registration endpoint enforces these rules:

slug: Must match /^[a-z0-9][a-z0-9-]*[a-z0-9]$/ — lowercase alphanumeric with hyphens, no leading/trailing hyphens, minimum 2 characters
name: Required, non-empty after trimming
category: Must be one of the 8 valid categories (if provided)
temperature: Must be between 0 and 1 (if provided)
max_tokens: Must be an integer between 1 and 32,768 (if provided)
max_context_messages: Must be an integer between 1 and 500 (if provided)
slug uniqueness: Returns HTTP 409 if the slug is already taken

What Happens After Registration

The app is created with status draft
Your user ID is set as the developer_id — only you can publish versions
The app is visible only to you in the Developer Portal
To make it available to users, you need to publish a version and pass review