Quickstart

Connect a computer, create your first agent, and have it complete its first task.

Before an agent can execute, the computer that runs it needs at least one supported AI coding tool installed and signed in — for example Claude Code, Codex, or Cursor. Multica does not ship these tools.

Desktop: can connect this computer automatically.
Web: connect from the command line in the next step.

2. Connect a computer

Agents execute work on the computers you connect. Open Configure → Runtimes at the bottom of the sidebar:

With Desktop: Desktop automatically registers this computer as a runtime and detects the installed AI coding tools. For a tool you just installed, click Refresh to detect it again.
With Web, or to add another computer: click Add a computer in the top right, then run the two commands from the dialog in a terminal on the target computer:

macOS / Linux
```
curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash
multica setup
```
Windows PowerShell
```
irm https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.ps1 | iex
multica setup
```
multica setup opens a browser to complete sign-in, then leaves the daemon running in the background. Once the daemon is online, the dialog usually detects the computer within a minute.

Success check: an online computer appears in the runtime list.

Add a computer dialog: two commands and the waiting-for-detection notice

The connection commands differ slightly on self-hosted instances — see the Self-host quickstart.

3. Create an agent

Open Workspace → Agents in the sidebar, click New agent, and pick a path:

Start blank: fill in the fields yourself. Only a name is strictly required — confirm the runtime and AI coding tool, then create.
Build with AI: describe what you want, and the Agent Builder asks questions and generates the configuration. This path needs an online runtime.

Everything else can be refined later — see Create and configure agents.

Success check: your agent appears in the agent list and shows as online.

Agent creation starting-point picker: Start blank and Build with AI

4. Hand it your first issue

Click New Issue at the top of the sidebar (or press C). In the default agent mode:

Under Created by, select the agent you just created.
Describe the work in a sentence or two, for example "Explain how this workspace can be used."
Submit. Multica creates the issue, sets the agent as the assignee, and starts executing immediately.

New issue dialog in agent mode: Created by set to Multica Assistant

5. Watch progress and results

After submitting, open the issue: the execution log shows the run status, and the agent's progress and replies appear in the timeline.

Success check: the execution log status changes to Completed and the agent's reply appears in the timeline. To see the full transcript, click View transcript.

The agent's reply in the issue and a completed execution log

Common problems

Symptom	Check first
No runtime found	Confirm the AI coding tool is installed and runs in a terminal. On Desktop, click Refresh; on the CLI path, rerun `multica setup`.
Runtime shows offline	Keep Desktop open; on the CLI path, run `multica daemon status`, and `multica daemon start` if it is not running.
Issue stays queued	Confirm the runtime the agent uses is online. When a runtime hits its concurrency limit, new tasks keep queueing.

For more cases, see Troubleshooting.

Next steps

Core concepts — meet all of Multica's core objects in three minutes.
How Multica works — how issues, agents, runtimes, and each run relate.
Put agents to work — beyond assignment: @-mentions, chat, and Autopilots.