MMosaic CLI

Mosaic CLI

A local coding agent that stays simple and fast.

This site covers installation, tool calling, providers, the Bubble Tea TUI, and the headless mode, with a minimal but more readable layout.

Install MosaicSee tool callingView version
Bubble Tea TUILM StudioOpenAIheadless
00

Install Mosaic

Pick an explicit installer, or let Mosaic detect Windows or Linux automatically.

Detects Windows or Linux and serves the right script.

install.autoshell
curl -fsSL https://mosaic.methil.group/api/install | sh
01

Tool calling

Mosaic keeps a clear loop: the model requests a tool, the CLI runs it, and the result returns to context before the final answer.

  • Readable flow for `read_file`, `write_file`, `edit_file`, and `run_command`.
  • The TUI keeps tool output and assistant text in one simple transcript.
  • Headless mode reuses the same protocol for automation.
tool_call.xmlxml
<tool_call>
  <name>read_file</name>
  <arguments>{"path":"src/app.ts"}</arguments>
</tool_call>
02

Providers

OpenAI and LM Studio are the primary targets, with room to connect an OpenAI subscription-backed account when the available setup supports it.

  • Provider selection in the TUI through `/provider`.
  • Model selection through `/models` with suggestions.
  • Automatic update checks through the website version API.
03

TUI

The terminal stays minimal, but configuration commands remain visible and suggested.

interactive.shshell
mosaic --workspace .
/provider openai
/models
04

Headless

The same engine can run without an interface for automation and local integrations.

headless.shshell
mosaic --workspace . --headless --prompt "Analyse ce repo"
05

Version API

The site exposes one version plus download and install URLs for automatic updates.

version.jsonjson
{
  "version": "0.0.17",
  "downloadUrl": "https://mosaic.methil.group/downloads/mosaic-linux-amd64",
  "installUrl": "https://mosaic.methil.group/api/install",
  "downloadUrls": {
    "linux": "https://mosaic.methil.group/downloads/mosaic-linux-amd64",
    "windows": "https://mosaic.methil.group/downloads/mosaic-windows-amd64.exe"
  },
  "installUrls": {
    "auto": "https://mosaic.methil.group/api/install",
    "linux": "https://mosaic.methil.group/api/install.sh",
    "windows": "https://mosaic.methil.group/api/install.ps1"
  }
}