docs/getting started/quickstart

Quickstart

Mousse is an Electron desktop orchestrator for parallel coding agents. Point it at a git repository, describe the work, and the orchestrator can dispatch agents into isolated worktrees. The app, terminals, credentials, and worktrees stay on your machine; your selected LLM provider handles model requests.

1 · Install

shellcopy
$ git clone https://github.com/bvsr365/mousse.git
$ cd mousse && npm install
$ npm run dev
requires Node.js 22.19+, npm, and Git

2 · Add a project

Open Mousse and add a git repository from the left rail. Threads are grouped per project, and each thread keeps its own agent history, plans and worktrees.

note

Mousse uses git worktrees to isolate agent tasks. Commit or stash important local changes before merging agent branches, and review each result before completion.

3 · Describe the work, approve the plan

Write to the main agent as you would to a lead. In plan mode it reads the repo and answers with a plan card — steps, files and a model per step. Edit any step, then hit Implement plan.

chat

Ask questions about the repo. Read-only — nothing is written.

plan

The main agent drafts a plan card you approve before any code runs.

build

One agent implements a scoped change directly in a worktree.

agent

Long-running autonomy: the main agent keeps delegating until done.

4 · Watch the fan-out

Each task becomes an agent in its own git worktree and branch, with a live terminal in the Agents panel. Take one over by typing into it; pause or kill it at any point.

branch
cli
task
mousse/checkout
claude-code
Checkout session route + redirect
mousse/webhooks
codex
Signature verification, idempotent upserts
mousse/usage
opencode
Metered price, rollup job, dashboard widget

5 · Drive it from the terminal

mousse-cli -p "<prompt>" Run a one-shot orchestrator request and print the response.
mousse-cli agents list List background CLI agents and their current status.
mousse-cli agents spawn --cli codex --task "…" Spawn a coding agent in an isolated git worktree.
mousse-cli schedule add --name "…" --cron "…" Register a scheduled orchestrator job.
mousse-cli channels add telegram --token "…" Configure Telegram; Discord and webhooks are also supported.

6 · Answer from anywhere

Connect a channel and the thread reaches you on your phone: approve plans, answer questions, or kick off a scheduled job. Adapters ship for Telegram, Discord and plain webhooks.