mirror of
https://gh-proxy.org/https://github.com/klinsmaya/multica.git
synced 2026-11-11 02:46:45 +08:00
CAVIN
7f12380f05
Adds `multica workspace create` (--name/--slug/--description/--context/--issue-prefix, JSON/table output). Creation does not switch the current workspace. Both --name and --slug are required to match the server contract, and the slug is immutable after creation. Docs (en/zh/ja/ko) and the CLI reference now show the executable command. Closes #5055
57 lines
3.2 KiB
Plaintext
57 lines
3.2 KiB
Plaintext
---
|
|
title: Workspaces
|
|
description: A workspace is the self-contained space where a group collaborates — every issue, member, comment, and agent belongs to one.
|
|
---
|
|
|
|
import { Callout } from "fumadocs-ui/components/callout";
|
|
|
|
A workspace is **the self-contained space where a group collaborates in Multica** — every [issue](/issues), [member](/members-roles), [comment](/comments), and [agent](/agents) belongs to one. The issue list, member roster, and agent configuration you see after logging in are all scoped to the current workspace; **switching workspaces replaces the entire view**.
|
|
|
|
## Creating a workspace
|
|
|
|
Three things get decided when you create a workspace:
|
|
|
|
- **Workspace name** — the display name members see. Spaces and non-ASCII characters are allowed. You can change it later.
|
|
- **Slug** — the string used in the workspace URL. Lowercase letters and digits only (joined with `-`). **It cannot be changed after creation**, so pick carefully. If the slug is taken or hits a system-reserved word, the create screen will ask you to choose another.
|
|
- **Issue prefix** — the prefix for every issue number in the workspace (the `MUL` in `MUL-123`). Uppercase letters and digits, up to 10 characters.
|
|
|
|
<Callout type="warning">
|
|
**Avoid changing the issue prefix.** Issue numbers are rendered with the current prefix — change it and `MUL-5` instantly becomes `NEW-5`. Every external link, Slack mention, and historical reference in comments breaks against the old number. Treat the issue prefix as "set at creation, never touched."
|
|
</Callout>
|
|
|
|
You can create a workspace from the web UI, or from the command line. Both `--name` and `--slug` are required, and creating a workspace does **not** switch your current one — run `multica workspace switch <slug>` afterward if you want to work in it:
|
|
|
|
```bash
|
|
multica workspace create --name "Support Team" --slug support-team --issue-prefix SUP
|
|
```
|
|
|
|
## Issue numbers
|
|
|
|
Every issue created in a workspace is automatically assigned a number in the format `<prefix>-<digits>` — `MUL-1`, `MUL-2`, `MUL-3`. A few properties:
|
|
|
|
- **Sequential and unique within a workspace** — each workspace keeps its own counter; workspaces don't interfere with each other.
|
|
- **Not manually assignable** — when you create an issue you only supply a title; the number is assigned by the system.
|
|
- **Never reclaimed on delete** — delete `MUL-5` and the next new issue is `MUL-6`, not `MUL-5`.
|
|
|
|
## Deleting a workspace
|
|
|
|
Only a workspace owner can delete the entire workspace. Deletion is **irreversible**.
|
|
|
|
<Callout type="warning">
|
|
Deleting a workspace wipes the following all at once:
|
|
|
|
- Every issue, project, comment, and reaction
|
|
- Every attachment
|
|
- Every membership and pending invitation
|
|
- Every agent configuration along with its task history
|
|
|
|
**Data cannot be recovered.** Export anything you need to keep before deleting.
|
|
</Callout>
|
|
|
|
If you're the last owner of a workspace and want to walk away from it, transfer the owner role to another member first, then have the new owner (or you) decide whether to delete. See [Members and roles](/members-roles).
|
|
|
|
## Next
|
|
|
|
- [Members and roles](/members-roles) — how to add people to a workspace, and what each of the three roles can do
|
|
- [Issues and projects](/issues) — the core work objects inside a workspace
|