Workspace Settings
Edit workspace identity and manage the danger zone actions.
Workspace Settings
Open Settings at the bottom of the sidebar to configure the workspace. The settings sidebar groups workspace administration into several sections:
| Section | Purpose |
|---|---|
| Workspace | Workspace identity and danger-zone actions (this page) |
| Members | Members, invitations, and per-member roles |
| Roles | Custom roles and permission scopes |
| Integrations | Connected integrations (e.g. Feishu/Lark) |
| Features | Workspace-level feature overrides. Available flags: Memory (cross-ticket agent memory) and Git (repository / GitHub integration). The system state set by admins still applies. |
| Repos | Registered git repositories — only visible when the Git feature is enabled |
Only Owners and Admins can edit settings; non-admins see a read-only view.
Workspace
The Workspace section controls how the workspace identifies itself.
| Field | Description |
|---|---|
| Name | Display name shown in the sidebar and breadcrumbs. Free-form text. |
| Slug | URL segment used in every workspace route (/{slug}/tickets, /{slug}/agents, …). Read-only — contact support to change it. Must be lowercase, 2–50 characters, letters, digits, and dashes only. |
| Identifier prefix | Short uppercase prefix prepended to ticket IDs (e.g. FOO → tickets become FOO-1, FOO-2, …). Up to 8 characters, letters and digits only. |
| Description | Optional plain-text blurb. Helps members understand the workspace's purpose. |
| Context | Optional free-form text injected into every AI agent's context for this workspace. Use this to share background knowledge that all agents should know — product area, codebase conventions, on-call contacts, etc. |
| Agent Task Token TTL (hours) | How long agent task tokens remain valid, in hours. Agent task tokens are short-lived credentials that let the daemon act on behalf of a ticket. Set to 0 to use the system default. |
Click Save to apply changes.
API Tokens are personal, not workspace-scoped. Manage them from your Profile page (
/{workspace}/profile).API Tokens are used to verify your identity when connecting your own machine or remote server as a runtime to the workspace. For example: if the workspace already has runtimes deployed by an administrator, but you want to add your own GPU workstation as an additional runtime, you would first create an API Token in your profile, then use it to register your machine.
Personal Agent Environment Variables
From your Profile settings, you can maintain key/value environment variables used by agent tasks started on your behalf. Values are masked in the UI and are encrypted before storage. Only you can update these variables.
At runtime, agent variables override personal variables; personal variables override provider and daemon-provided mutable variables. Daemon security variables remain protected. A task uses the variables belonging to its origin_user_id.
Danger Zone
The Danger Zone holds destructive actions. Only the workspace Owner can delete the workspace; Admins and Members can leave it.
Leave Workspace
Available to non-owner members and admins. Removes your access to the workspace immediately. An Owner can re-invite you at any time.
Delete Workspace
Owner-only. Permanently deletes:
- The workspace and its slug (the slug becomes available again after a short cooldown)
- Every ticket, project, comment, attachment, label, and dependency
- Every agent, agent task, skill, team, and job configured in the workspace
- Every membership, invitation, and team assignment
Personal accounts and other workspaces you belong to are untouched.
The action requires typing the workspace slug to confirm. Once submitted, the deletion is immediate and irreversible — export anything you need first.
Command-line Reference
# List all workspaces you belong to
mopheus workspace list
# Switch the active workspace
mopheus workspace switch <workspace-id>
# Update workspace name or description
mopheus workspace update <workspace-id> --name "New Name" --description "Updated description"
# View your profile
mopheus user profile get
# Update your language preference
mopheus user profile update --language enUser shortcut commands
Save reusable Markdown snippets on your account and insert them from the / menu in chat and ticket comments. Commands can be global or scoped to a workspace; a workspace command with the same name overrides the global command in that workspace.
mopheus user shortcut list
mopheus user shortcut create --name review --description "Review changes" --content "Please review the diff."
mopheus user shortcut update <id> --content "Updated instructions"
mopheus user shortcut delete <id> --yesShortcut command APIs and CLI operations are user-owned and cannot be accessed with an agent task token.
Web UI languages
The Mopheus web application supports English, Simplified Chinese, and Japanese. Open your profile settings, choose a language, and the selection is applied immediately and saved to your profile. Japanese is stored as ja; Japanese browser tags such as ja-JP are normalized to this locale. The marketing and documentation sites have separate localization settings.