Skip to content

A place for every how-to.

The Mellow reference library.

Build your workspace, shape your agents and understand how the work gets done. Explore detailed setup, controls, examples and troubleshooting in seven collections.

What would you like to do?Browse a collection

59 topics

Start with Mellow

4 topics

Meet your Mellow workspace

Understand agents, models, devices and the place Mellow has within Visca.

Install and update

Prepare your Mac, install Mellow and check the build you are running.

Your first useful conversation

Choose an agent and a ready model, then complete a small task you can verify.

Mellow vocabulary

A plain-language map of the concepts used throughout the app and this reference.

Your daily workspace

6 topics

Conversations and context

Start, continue and organize chats while keeping their model, context and destination clear.

Projects and working folders

Keep related work together and choose the files an agent can work with.

From request to finished work

Follow a task through model responses, tools, approvals and its final result.

Files and knowledge collections

Give agents a reference library, manage indexing and understand what a collection provides.

Remembered context

Control the information carried between conversations and inspect memory processing.

Shortcuts and quick actions

Ask the active agent for a reply or dispatch a selected agent from macOS Shortcuts.

Build your agent team

8 topics

Your agents

Set each helper’s instructions, model and capabilities for a specific kind of work.

Working with the Orchestrator

Coordinate allowed helpers and review the results in one conversation.

Delegating to helpers

Understand delegation, parallel work, resource limits and how results return.

Skills and reusable instructions

Install and manage task guidance without confusing instructions with executable permissions.

Reusable workflows

Save procedures for work you repeat and decide when an agent should use them.

Scheduled routines

Choose an agent, instructions and a time; inspect runs and missed-run behavior.

Folder-triggered routines

Turn relevant file changes into bounded, repeatable agent tasks.

Agent records and self-scheduling

Use persistent records and scheduled follow-ups within an agent’s allowed capabilities.

Connect your workspace

13 topics

Devices and Mobile

Pair a client with a host Mac and understand where its conversations and tools run.

Cloud workspaces

Sign in to a workspace, discover permitted agents and track submitted cloud work.

Messaging channels

Connect incoming conversations, configure replies and review outbound behavior.

Working with Mac apps

Configure access to supported Apple apps and understand per-action permissions.

Browser tasks

Give an agent a browser session and review navigation, page context and actions.

Working on your screen

Prepare macOS permissions and inspect tasks that operate real application interfaces.

Research on the web

Choose search capabilities and separate search results from verified source content.

Tools and extensions

Enable executable capabilities, inspect their contracts and manage installed extensions.

MCP connections

Connect external tool servers and diagnose authentication or discovery problems.

Importing plugin packages

Understand which package components Mellow can use and what needs separate setup.

Connecting other clients

Choose the right integration path for model clients, tools and agent execution.

Public access links

Understand what a reachable host link provides and how access is authorized.

Encrypted device connections

Follow identity checks, pairing and encrypted communication between devices.

Models, voice and media

7 topics

Choosing and managing models

Install compatible models, select a conversation model and diagnose loading or memory issues.

Provider connections

Configure endpoints, protocol types and credentials for your model accounts.

Apple’s on-device model

Check Foundation availability, choose suitable tasks and handle its context limits.

Hosted inference

Distinguish model-service readiness and billing from Cloud workspace sign-in.

Speaking and dictation

Configure recognition, chat input, text insertion, wake phrases and stop behavior.

Spoken replies

Set up on-device synthesis or a compatible speech server and test playback.

Images and video

Choose media capabilities, manage local model preparation and inspect hosted jobs.

Make it yours

6 topics

Coats and appearance

Choose a companion coat, set app appearance and create readable custom themes.

Your Mellow identity

Understand local identity, credentials and the distinction from workspace sign-in.

Permissions and privacy

Follow what an agent can access and where task information is processed.

Filtering sensitive text

Configure outbound filtering and understand what the filter can and cannot cover.

Data and encryption

Locate stored data, manage protection and plan backups or cleanup.

Activity and diagnostics

Inspect operational records and prepare useful diagnostic information.

Build with Mellow

15 topics

How Mellow fits together

Trace the app, local server, model services and execution boundaries.

HTTP API

Discover models, call inference endpoints or choose the agent execution lifecycle.

Command-line workflows

Operate the local server and tools with the commands supported by this build.

Client recipes

Build small clients that handle responses, errors and the appropriate execution contract.

Configuration reference

Understand settings ownership, local paths and supported runtime overrides.

Inspecting and debugging

Use server controls and diagnostic surfaces to investigate a failing workflow.

Build the app

Prepare the checkout and toolchain, build Mellow and separate development from release delivery.

Tool execution contracts

Design structured inputs, results and permissions for callable capabilities.

Author an extension

Start from a supported scaffold and validate an extension against the current runtime.

Inside inference

Understand model resolution, loading, streaming and request failures.

Sandbox execution

Follow runtime preparation, environment boundaries and agent code execution.

Inside memory

Trace memory processing, storage and the diagnostics behind remembered context.

Inside folder watchers

Understand event handling, batching and dispatch for file-triggered work.

Identity and signing

Inspect the cryptographic identity and request-signing contracts.

Network proxy configuration

Configure shared network routing and distinguish proxy failures from service errors.