mirror of
https://gh-proxy.org/https://github.com/klinsmaya/multica.git
synced 2026-11-11 02:46:45 +08:00
54e641aaa3
* fix(copy): rename agent task records to runs Co-authored-by: multica-agent <[email protected]> * fix(copy): finish run terminology migration Co-authored-by: multica-agent <[email protected]> * fix(copy): address terminology review follow-ups Co-authored-by: multica-agent <[email protected]> * fix(docs): address final run terminology review Co-authored-by: multica-agent <[email protected]> --------- Co-authored-by: multica-agent <[email protected]> Co-authored-by: Lambda <[email protected]>
96 lines
4.5 KiB
Plaintext
96 lines
4.5 KiB
Plaintext
---
|
|
title: Quickstart
|
|
description: Connect a computer, create your first agent, and have it complete its first task.
|
|
---
|
|
|
|
import { Callout } from "fumadocs-ui/components/callout";
|
|
|
|
<Callout type="info">
|
|
Before an agent can execute, the computer that runs it needs at least one [supported AI coding tool](/providers) installed and signed in — for example Claude Code, Codex, or Cursor. Multica does not ship these tools.
|
|
</Callout>
|
|
|
|
## 1. Sign in and open your workspace
|
|
|
|
Sign in on the web ([multica.ai](https://multica.ai)) or with [Multica Desktop](https://multica.ai/download). Email verification codes and Google are both supported.
|
|
|
|
- **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**
|
|
|
|
```bash
|
|
curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash
|
|
multica setup
|
|
```
|
|
|
|
**Windows PowerShell**
|
|
|
|
```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.
|
|
|
|
|
|
|
|
<Callout type="info">
|
|
The connection commands differ slightly on self-hosted instances — see the [Self-host quickstart](/self-host-quickstart).
|
|
</Callout>
|
|
|
|
## 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](/agents-create).
|
|
|
|
**Success check**: your agent appears in the agent list and shows as online.
|
|
|
|
|
|
|
|
## 4. Hand it your first issue
|
|
|
|
Click **New Issue** at the top of the sidebar (or press `C`). In the default agent mode:
|
|
|
|
1. Under **Created by**, select the agent you just created.
|
|
2. Describe the work in a sentence or two, for example "Explain how this workspace can be used."
|
|
3. Submit. Multica creates the issue, sets the agent as the assignee, and starts executing immediately.
|
|
|
|
|
|
|
|
## 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**.
|
|
|
|
|
|
|
|
## 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 runs keep queueing. |
|
|
|
|
For more cases, see [Troubleshooting](/troubleshooting).
|
|
|
|
## Next steps
|
|
|
|
- [Core concepts](/concepts) — meet all of Multica's core objects in three minutes.
|
|
- [How Multica works](/how-multica-works) — how issues, agents, runtimes, and each run relate.
|
|
- [Put agents to work](/triggering-agents) — beyond assignment: @-mentions, chat, and Autopilots.
|