DOCUMENTATION & REFERENCE

Mosaic CLI & App Guide

A focused reference for autonomous coding commands, hardware acceleration, remote machines and everyday App workflows.

26 references

REFERENCE

Getting Started

6 items

mosaicGetting Started

Launch the interactive TUI coding agent in the current workspace directory.

Example

$mosaic

mosaic .Getting Started

Open the current directory with auto-detected local model configuration.

Example

$mosaic .

mosaic chatGetting Started

Start a conversational chat session without workspace tools, shell execution, or web access.

Example

$mosaic chat

mosaic "<instruction>"Getting Started

Execute a headless autonomous prompt directly from your terminal and exit upon verification.

Example

$mosaic "Fix memory leak in buffer pool and run test suite"

mosaic machine linkGetting Started

Link the current machine to your account and automatically prepare its compatible Crea image runtime, or add --anon to share a restricted machine with Methil members without GitHub authentication.

Example

$mosaic machine link --anon

--creative-model <id>Getting Started

Declare a creative specialization for a linked machine. Repeat the flag to make one worker serve several catalogued models; omit it to expose the complete catalog.

Example

$mosaic machine link --anon --creative-model krea-2-turbo --creative-model ltx-2.5

REFERENCE

Slash Commands

8 items

/setupSlash Commands

Open the hardware auto-configuration wizard to benchmark GPU/RAM and pick optimal models.

/model <id>Slash Commands

Switch the active language model on the fly (e.g. /model qwen3.8-27b-q4_k_m).

/provider <name>Slash Commands

Switch provider route (local, lmstudio, openai, openrouter, anthropic, ollama).

/doctorSlash Commands

Run comprehensive workspace diagnostics, verify build tools, git tree, and runtime dependencies.

/statusSlash Commands

Display current token usage, active provider, context budget, and system resource telemetry.

/diffSlash Commands

View pending file changes and uncommitted git modifications generated by the agent.

/reviewSlash Commands

Initiate an automated code review pass on recent edits before committing.

/newSlash Commands

Reset conversational context and start a fresh coding session.

APP CONTROL

Remote Machine Control

4 items

mosaic machinesRemote Machine Control

List all linked compute nodes, online statuses, accelerators, and memory capacity.

Example

$mosaic machine list

mosaic machine statusRemote Machine Control

Inspect local machine registration, system daemon health, and telemetry heartbeat.

Example

$mosaic machine status

Mosaic Crea model queueRemote Machine Control

From App / Machines, enqueue an allowlisted Krea 2, MiniMax H3, MiniMax Music3 or LTX-2.5 download on a compatible online worker. Progress and logs stay attached to the preparation job.

Example

$mosaic machine link --anon --creative-model minimax-music3

mosaic machine rotate-tokenRemote Machine Control

Rotate the cryptographic access token of this computer and re-authenticate.

Example

$mosaic machine rotate-token

REFERENCE

CLI Flags & Options

5 items

--provider <provider>CLI Flags & Options

Override default model provider (local, openrouter, openai, anthropic, deepseek).

Example

$mosaic --provider openrouter --model deepseek/deepseek-v4-pro

--workspace <dir>CLI Flags & Options

Set target root directory for workspace inspection and tool executions.

Example

$mosaic --workspace ~/projects/backend

--jsonCLI Flags & Options

Format output as structured JSON / JSONL for CI/CD pipeline automation.

Example

$mosaic doctor --probe --json

--no-creativeCLI Flags & Options

Disable the creative model catalog for this machine when it should only provide language-model inference.

Example

$mosaic machine link --no-creative

--no-imageCLI Flags & Options

Skip automatic Crea image runtime preparation during machine link when the host should only provide language-model inference.

Example

$mosaic machine link --no-image

REFERENCE

Hardware & Runtimes

3 items

Apple Silicon MLXHardware & Runtimes

Native unified memory acceleration for M1/M2/M3/M4 Macs. Zero VRAM overhead, instant startup via HuggingFace MLX community.

llama.cpp (Metal & CUDA)Hardware & Runtimes

Ultra-portable GGUF inference supporting split CPU/GPU layer offload with quantized KV cache.

SGLang & vLLMHardware & Runtimes

High-throughput server engines for Linux NVIDIA CUDA and AMD ROCm with FP8 / MXFP4 support.

DEEP DIVE

Hardware Auto-Configuration & Memory Safety

Mosaic dynamically detects your system's memory topology at startup. On Apple Silicon, Darwin virtual memory counters (vm_stat) are parsed to distinguish active wired memory from reclaimable page caches, helping quantizations like Qwen3.8 27B or Qwen3.5 4B MLX fit safely in available RAM without kernel OOM panic.

On Linux workstations with NVIDIA or AMD hardware, Mosaic queries PyTorch and ROCm sysfs counters to balance layer offloading between dedicated VRAM and host RAM.