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.
1,006 Commits 17 Branches 3 Tags 13 MiB
Dart 90.8%
Shell 4.2%
C++ 2%
Swift 0.9%
CMake 0.8%
Other 1.2%
ef849d7317
Go to file
Haitao Pan ef849d7317 fix(prompt): simplify gateway workspace context to avoid conflicting paths (S5) 
Every gateway turn's prompt prefix injected three near-duplicate absolute paths:
currentTaskWorkspace + localWorkspace + remoteWorkspaceHint. localWorkspace is the
App's LOCAL thread dir (~/.xworkmate/threads/...) which the gateway agent cannot
access, and remoteWorkspaceHint duplicates currentTaskWorkspace. The conflicting
paths leave the agent unsure where to work and can block conversation continuation.

For gateway turns the prompt now carries only currentTaskWorkspace (the plugin owns
the artifact scope); localWorkspace is kept only for non-gateway (local agent runs
there); remoteWorkspaceHint is dropped when equal to currentTaskWorkspace. sessionKey
is kept (short, not a path). UI is unaffected (chat bubble shows the raw user message;
the prompt-debug parser only special-cases Execution context / Preferred skills /
Attached files). Tests updated; assistant_execution_target_test green (74).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-27 12:15:27 +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 fix(prompt): simplify gateway workspace context to avoid conflicting paths (S5) 2026-06-27 12:15:27 +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(prompt): simplify gateway workspace context to avoid conflicting paths (S5) 2026-06-27 12:15:27 +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 fix(prompt): simplify gateway workspace context to avoid conflicting paths (S5) 2026-06-27 12:15:27 +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 fix(macos): suppress file selector deprecation warning 2026-06-27 11:48:51 +08:00
pubspec.yaml fix(macos): suppress file selector deprecation warning 2026-06-27 11:48:51 +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