xworkmate-app/README.md
Haitao Pan d890acb661
feat: add one-line XWorkmate installer (#42)
Co-authored-by: Haitao Pan <manbuzhe2009@qq.com>
2026-06-29 15:48:49 +08:00

2.4 KiB

xworkmate-app

Flutter-based AI workspace shell for running assistant threads with local and remote gateway task execution via ACP bridge.

Architecture

Single execution path: Flutter → GoTaskServiceClient → ACP Transport → xworkmate-bridge → Remote Provider

See docs/architecture/ for the full architecture documentation.

Dependencies

Repository Role
xworkmate-bridge Go-based ACP control plane and bridge backend
xworkspace-core-skills Core skill bundles (pptx, docx, xlsx, pdf, image, browser automation)
openclaw-multi-session-plugins OpenClaw Gateway multi-session plugin runtime
playbooks Deployment playbooks and infrastructure automation

Quick Start

git clone https://github.com/x-evor/xworkmate-app.git
cd xworkmate-app
flutter pub get
flutter analyze
flutter test
flutter run -d macos

For local development, keep xworkmate-bridge checked out alongside xworkmate-app, or set XWORKMATE_BRIDGE_DIR explicitly before building.

macOS (Xcode)

open macos/Runner.xcworkspace
# or
make open-macos-xcode

In Xcode:

  • Select the shared Runner scheme
  • Select My Mac as the destination
  • Configure signing only on the Runner target
  • Leave CocoaPods plugin targets under Pods alone

For release builds:

flutter build macos
make build-macos

For a one-line install from the latest GitHub release:

curl -sfL https://install.svc.plus/xworkmate-app | bash -

Downloads

Platform Download
macOS Latest Release
Windows Latest Release
Linux Latest Release
iOS Latest Release
Android Latest Release

Learn More