ai-workspace-lab/xworkmate-app
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
XWorkmate is a Flutter-based AI workspace shell for running assistant threads, local or remote gateway tasks, and multi-agent collaboration in one app.
995 Commits 17 Branches 3 Tags 13 MiB
Dart 90.8%
Shell 4.2%
C++ 2%
Swift 0.9%
CMake 0.8%
Other 1.2%
3993f682be
Go to file
Haitao Pan 3993f682be docs(cases/06): definitive 4-layer chain incl. multi-session plugin + live verification 
Rewrites the timeline (§1) and topology (§2) as the correct FOUR-layer chain
App → bridge → openclaw-multi-session-plugins → OpenClaw gateway, and documents the
plugin's multi-session/multi-thread role: session mapping (appThreadKey⇄openclawSessionKey),
per-(session,run) artifactScope = tasks/<sanitize(sessionKey)>/<runId>, the strict
sessionKey/runId/artifactScope triplet validation, and the expectedArtifactDirs
workspace-root fallback scan.

Live-verified against 127.0.0.1:8787 (plugin loaded, commit 2333c3e):
- session.prepare returns a real mapping; chat.send returns runId; xworkmate.tasks.get
  is handled by the plugin but returns no_native_task_record with an empty task scope
  (chain reaches the plugin layer; the agent run produced no queryable task / no file —
  a layer-4 execution/landing issue).

Adds §7 stability improvements grounded in this live run:
- S0 install the plugin from a stable path (not /private/tmp) — the primary reliability fix.
- S1 expectedArtifactDirs was [] → the plugin's workspace-root fallback is inert; bridge
  should always pass default dirs (reports/, artifacts/).
- S2 no_native_task_record status ambiguity (running vs completed-without-artifact).
- S3 sessionKey/runId/artifactScope triplet consistency (don't pre-prefix agent:main:).
- S4 runtime observability across all four layers.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-26 23:18:04 +08:00
.github ci: refresh app workflows for node 24 2026-06-26 19:27:30 +08:00
android Add multi-platform build and release workflow 2026-03-21 10:08:12 +08:00
assets chore(aris): remove legacy ARIS assets and clean up associated code 2026-04-17 18:07:04 +08:00
config chore: update macOS deployment target to 14.0 and commit pending changes 2026-06-25 09:52:33 +08:00
docs docs(cases/06): definitive 4-layer chain incl. multi-session plugin + live verification 2026-06-26 23:18:04 +08:00
images docs: simplify root readme 2026-03-26 09:49:58 +08:00
integration_test Add desktop settings integration test 2026-05-26 11:46:32 +08:00
ios Remove Patrol from macOS package 2026-06-05 21:47:08 +08:00
lib fix(gateway): harden OpenClaw task recovery tests 2026-06-26 18:30:34 +08:00
linux feat: Remote Desktop UI and Client WebRTC Integration 2026-06-03 10:50:06 +08:00
macos chore: update macOS deployment target to 14.0 and commit pending changes 2026-06-25 09:52:33 +08:00
packaging/windows Add multi-platform build and release workflow 2026-03-21 10:08:12 +08:00
releases/v0.5 Remove bundled app helper binaries 2026-04-11 14:45:50 +08:00
scripts test: keep layered flutter tests aligned with repo 2026-06-26 19:39:14 +08:00
test test: stabilize assistant gateway recovery cases 2026-06-26 20:01:31 +08:00
third_party Make workspace advanced configs extensible 2026-06-08 16:35:15 +08:00
tmp Add local tmp cache directory 2026-03-23 12:23:17 +08:00
tool Refactor bridge runtime routing 2026-04-21 16:28:26 +08:00
windows feat: Remote Desktop UI and Client WebRTC Integration 2026-06-03 10:50:06 +08:00
.gitignore chore: remove stale Flutter code 2026-06-12 14:52:23 +08:00
.gitmodules Implement local-first single-agent artifact sync 2026-04-10 14:59:42 +08:00
.metadata Initial Flutter workspace shell 2026-03-11 07:32:52 +08:00
agent.md Unify single-agent task flow under ACP 2026-04-08 20:27:35 +08:00
AGENTS.md Remove Patrol from macOS package 2026-06-05 21:47:08 +08:00
analysis_options.yaml Fix macOS archive symbols and packaging settings 2026-03-27 16:32:23 +08:00
CHANGELOG.md Remove bundled app helper binaries 2026-04-11 14:45:50 +08:00
dart_test.yaml Integrate gateway settings into integrations page 2026-03-22 17:07:27 +08:00
LICENSE Initial commit 2026-03-11 00:49:57 +08:00
Makefile Remove Patrol from macOS package 2026-06-05 21:47:08 +08:00
package.json Initial Flutter workspace shell 2026-03-11 07:32:52 +08:00
pubspec.lock Add AI workspace management provisioning flow 2026-06-08 15:52:26 +08:00
pubspec.yaml Add AI workspace management provisioning flow 2026-06-08 15:52:26 +08:00
README.md docs: rewrite README — fix repo name, remove stale multi-agent refs, add dependencies 2026-06-04 07:01:18 +00:00

README.md

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

Downloads

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

Learn More