ai-workspace-lab/xworkspace-console
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
109 Commits 8 Branches 91 Tags 6.1 MiB
Shell 46.6%
TypeScript 18.6%
CSS 16.6%
Python 12.3%
Go 5.8%
11701c6037
Go to file
Haitao Pan 11701c6037 fix(macos): patch vault role post-clone for macOS-standard dirs 
The vault role's 'Ensure standalone Vault directories exist' task creates
/etc/vault.d and /opt/vault/data with owner: root and lacks the Darwin guard
its sibling tasks have, so it fails under macOS become=false. Unlike the
bridge dir (owned by the service user, fixable via -e), this owner: root is
hardcoded and not overridable, so the role logic must change.

Since the role lives in a separate playbooks repo, reuse the existing
post-clone patch mechanism (cf. patch_playbook_user_systemd): add
patch_playbook_vault_macos() that, on Darwin only, guards the directory task,
makes vault dirs/binary OS-conditional (macOS -> ~/Library/Application
Support/vault[/data], /opt/homebrew/bin/vault; Linux unchanged), and creates
the user-owned data dir in macos.yml. Idempotent; verified against the real
role. Documents TC-MAC-013.
2026-06-18 11:33:42 +00:00
.github/workflows fix: delete existing offline release assets before upload 2026-06-18 18:05:24 +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 style(ui): update reset auth token button to solid red button with translated hover tooltip 2026-06-17 09:15:13 +08:00
docs fix(macos): patch vault role post-clone for macOS-standard dirs 2026-06-18 11:33:42 +00:00
scripts fix(macos): patch vault role post-clone for macOS-standard dirs 2026-06-18 11:33:42 +00:00
tests fix: support Debian 13 offline bootstrap 2026-06-18 18:08:16 +08:00
.gitignore feat: wire dashboard to live runtime status 2026-06-13 07:41:47 +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

XWorkspace Console homepage 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

  1. 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 -
  1. 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

  1. Open the console via your browser:
http://127.0.0.1:17000
  1. Or launch the local desktop console application:
./scripts/setup-xworkspace-desktop.sh

Download

Docs / Links