Go to file

Haitao Pan 7fd48bbf74 docs(macos): record TC-MAC-028..033 and refresh delivery plan Document the six macOS issues found and fixed during end-to-end verification of the all-in-one install: litellm dependency version-probe SyntaxError (TC-028), prisma generator PATH (TC-029), QMD plist undefined nodejs_version (TC-030), QMD better-sqlite3 Node ABI mismatch (TC-031), XFCE/XRDP apt-on-macOS (TC-032), and litellm DATABASE_URL password percent-encoding / P1013 (TC-033), each with its playbooks commit. Update the fix-dimension summary and the runtime delivery plan status. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>		2026-06-22 13:25:12 +08:00
.github/workflows	chore: rename workflow to offline-package prefix and implement openclaw plugin macOS patch	2026-06-21 16:17:30 +08:00
api	feat(ai): parameterize LiteLLM URL and models, cascade auth token rotation to openclaw.json	2026-06-17 06:45:13 +08:00
assets/readme	docs: add homepage screenshot to readme	2026-06-15 14:26:22 +08:00
config	feat: configure portal services and terminal	2026-06-14 08:43:53 +08:00
dashboard	chore: rename workflow to offline-package prefix and implement openclaw plugin macOS patch	2026-06-21 16:17:30 +08:00
docs	docs(macos): record TC-MAC-028..033 and refresh delivery plan	2026-06-22 13:25:12 +08:00
scripts	feat(uninstall): print teardown plan and purge path status	2026-06-22 12:37:59 +08:00
tests	fix: refresh offline repositories on fresh hosts	2026-06-19 10:26:37 +08:00
.gitignore	feat(uninstall): print teardown plan and purge path status	2026-06-22 12:37:59 +08:00
LICENSE	Initial commit	2026-06-06 17:45:23 +08:00
README.md	feat: full macOS (Darwin) compatibility fixes for setup scripts	2026-06-18 16:26:44 +08:00

README.md

XWorkspace Console

XWorkspace Console is the local AI workspace control plane for AI Workspace Lab. It brings together a React dashboard, Go status API, systemd user services, and XFCE desktop templates into one tabbed surface for services, runtime, terminal access, and workspace navigation.

Preview

Image / Video

Image and video workflows fit naturally as custom tabs inside the same console shell. This keeps artifact review, service switching, and runtime operations in one place instead of scattering them across separate apps.

About

Single entry point for the workspace UI at http://127.0.0.1:17000
Tab-first console for Workspace, services, runtime, and embedded tools
Designed to coordinate local AI services, gateway access, and desktop bootstrap flows
Backed by dashboard/, api/, config/, scripts/, and docs/

Start TLDR

Note: Currently supports macOS, Debian, and Ubuntu. Other systems are untested.

Installation

Start the all-in-one installer:

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -

Automatic model registration (via API Keys):

Exporting keys before running the installer automatically registers models (e.g., DeepSeek, NVIDIA, OLLAMA/GLM) in the gateway:

export DEEPSEEK_API_KEY="sk-..."
export NVIDIA_API_KEY="nvapi-..."
export OLLAMA_API_KEY="your-key-here"

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -

Uninstallation

# Standard uninstall (keeps configurations and states)
curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- uninstall

# Purge (removes all data, keys, and configurations)
curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- uninstall --purge

Usage

Open the console via your browser:

http://127.0.0.1:17000

Or launch the local desktop console application:

./scripts/setup-xworkspace-desktop.sh

Download

Latest source: GitHub repository
Releases: GitHub Releases
Bootstrap script: scripts/setup-ai-workspace-all-in-one.sh
Offline installer docs: docs/OFFLINE_AI_WORKSPACE_INSTALLER.md