MaiaChat Help

What MaiaChat Can Do

A practical manual for chat, agents, MOA, automation, channels, documents, memory, settings, and the workflows that connect them.

Chat

The main workspace for model conversations, tools, memory, documents, voice, and agent-assisted work.

Agents And Profiles

Agents define roles, models, prompts, priorities, and permissions. Profiles bundle agents into reusable teams.

Mixture Of Agents

MOA runs several selected agents as independent reference thinkers, then asks an aggregator agent to compare and synthesize the best final answer.

Automation

Scheduled tasks, event triggers, background agents, boot scripts, and worker boards support long-running or recurring work.

Channels

Connect MaiaChat to external messaging surfaces and configure safe channel-specific behavior.

Settings And Administration

Settings control models, API keys, memory, media, integrations, cost, skills, backups, and personal data.

Quick Start

Common Workflows

Ask a simple question

Open Chat, choose a model, and send a message.

Use your files

Upload documents, enable retrieval, then ask about the selected files.

Use specialists

Create agents, add clear system prompts, then use them in chat or profiles.

Automate recurring work

Create a scheduled task and choose model, agent, loop, script, or MOA mode.

Chat

The main workspace for model conversations, tools, memory, documents, voice, and agent-assisted work.

Start a normal chat

Open Chat, choose a model, type your message, and send. MaiaChat stores the conversation and can generate a title automatically.

  1. 1Use New Chat from the sidebar.
  2. 2Choose a model if you do not want the default.
  3. 3Enable tools, skills, memory, or retrieval only when needed.
Use tools and skills

Tools let the assistant search the web, calculate, work with files, call approved integrations, or run configured local capabilities.

  1. 1Enable Tools in chat.
  2. 2Select only the tools needed for the task.
  3. 3Use approvals for sensitive shell or workflow actions when configured.
Use documents and retrieval

Documents can be searched through local RAG, Gemini stores, or both. The assistant receives retrieved context as a system message.

  1. 1Upload documents in Documents.
  2. 2Enable retrieval in Chat.
  3. 3Select relevant documents or stores when the task needs source material.
Use memory

Memory lets MaiaChat reuse relevant previous conversation context, user profile facts, and curated notes.

  1. 1Enable Memory in Chat.
  2. 2Ask naturally; the assistant will use relevant memories without forcing them into every answer.
  3. 3Update or inspect memory from Settings when needed.

Agents And Profiles

Agents define roles, models, prompts, priorities, and permissions. Profiles bundle agents into reusable teams.

Configure an agent

Create an agent with a name, role, provider/model, system prompt, tools, priority, and optional retrieval settings.

  1. 1Open Agents.
  2. 2Create or edit an agent.
  3. 3Use the system prompt to define the agent's specialty and boundaries.
  4. 4Set priority higher for agents that should influence coordination more.
Use profiles

Profiles collect multiple agents and set the default orchestration mode for that team.

  1. 1Open Profiles.
  2. 2Add the agents that belong together.
  3. 3Choose single, sequential, parallel, hierarchical, consensus, or MOA based on the task.
Choose an orchestration mode

Single uses one agent. Sequential passes work agent-to-agent. Parallel gets independent answers. Consensus synthesizes. Hierarchical coordinates. MOA fans out to references and synthesizes with an aggregator.

Mixture Of Agents

MOA runs several selected agents as independent reference thinkers, then asks an aggregator agent to compare and synthesize the best final answer.

When to use MOA

Use MOA for complex planning, architecture, research, high-stakes writing, debugging strategy, or any task where independent perspectives improve the result.

  1. 1Select at least two active agents.
  2. 2Use diverse models or roles when possible.
  3. 3Give a clear task prompt.
  4. 4Let the aggregator produce the final response.
How execution works

Reference agents run concurrently. Their drafts are hidden by default. The crowned aggregator receives the successful drafts, critiques them, resolves conflicts, and returns one answer.

How the aggregator is chosen

The chat selector marks the actual MOA aggregator with a crown. MaiaChat chooses a selected coordinator first, reviewer second, and otherwise the highest-priority selected active agent.

Failure behavior

MOA requires at least two successful reference drafts by default. If aggregation fails after enough references succeeded, MaiaChat falls back to the strongest successful reference answer.

Where MOA is available

MOA is available in multi-agent chat, profiles, channels, scheduled tasks, and the scheduled-task tool interface.

Automation

Scheduled tasks, event triggers, background agents, boot scripts, and worker boards support long-running or recurring work.

Scheduled tasks

Run prompts on a schedule using a model, isolated agent, loop, script, or MOA agent set.

  1. 1Open Scheduled Tasks.
  2. 2Choose the execution mode.
  3. 3For MOA, select at least two agents.
  4. 4Choose a schedule and optional delivery channel.
Event triggers

Trigger workflows from incoming events or webhooks rather than a time schedule.

Background agent

Use background execution for work that should continue outside the active chat screen.

Worker board

Inspect autonomous work, blockers, artifacts, approvals, and recent task state from one operational view.

Channels

Connect MaiaChat to external messaging surfaces and configure safe channel-specific behavior.

Supported channels

The app includes channel infrastructure for webchat and messaging platforms such as Slack, Discord, Telegram, WhatsApp, Teams, Signal, SMS, and email depending on configured connectors.

Channel multi-agent mode

Channels can use sequential, parallel, consensus, or MOA mode with selected agents.

  1. 1Open Channels.
  2. 2Choose a channel.
  3. 3Enable multi-agent behavior.
  4. 4Select the mode and the agent set.
Channel safety

Channel permission profiles control which tools are exposed, whether filesystem access is available, and how unknown contacts are handled.

Settings And Administration

Settings control models, API keys, memory, media, integrations, cost, skills, backups, and personal data.

Provider API keys

Add keys for providers such as OpenAI, Anthropic, Google, xAI, Perplexity, OpenRouter, or local model providers where available.

Skills and integrations

Enable reusable skills and connected services from Settings. The chat can use only the capabilities that are enabled and allowed.

Cost and usage

Usage tracking and cost settings help monitor token spend and provider routing behavior.

Approvals

Sensitive actions can require approval before execution, especially command, workflow, and channel-triggered operations.