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.
628 Commits 17 Branches 3 Tags 13 MiB
Dart 90.8%
Shell 4.2%
C++ 2%
Swift 0.9%
CMake 0.8%
Other 1.2%
58b8e398f2
Go to file
Haitao Pan 58b8e398f2 Merge pull request #12 from x-evor/codex/provider-selection-test-mainline 
Codex/provider selection test mainline
2026-04-14 15:03:46 +08:00
.github Merge pull request #12 from x-evor/codex/provider-selection-test-mainline 2026-04-14 15:03:46 +08:00
android Add multi-platform build and release workflow 2026-03-21 10:08:12 +08:00
assets chore: commit remaining workspace changes 2026-03-25 14:25:24 +08:00
config Clean C/S surfaces down to assistant and settings 2026-04-13 12:14:12 +08:00
docs Drive task dialog providers from bridge catalog 2026-04-14 10:05:10 +08:00
images docs: simplify root readme 2026-03-26 09:49:58 +08:00
ios fix: streamline gateway settings and mac packaging cleanup 2026-04-09 11:39:00 +08:00
lib test: lock provider selection mainline contract 2026-04-14 13:56:58 +08:00
linux Add desktop background-run lifecycle hooks 2026-03-26 18:42:11 +08:00
macos fix(macos): sync Podfile lock checksum 2026-04-13 14:37:36 +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
rust fix: resolve Rust FFI compilation errors and simplify build 2026-03-14 09:52:13 +08:00
scripts Merge pull request #12 from x-evor/codex/provider-selection-test-mainline 2026-04-14 15:03:46 +08:00
test test: lock provider selection mainline contract 2026-04-14 13:56:58 +08:00
tmp Add local tmp cache directory 2026-03-23 12:23:17 +08:00
tool docs: consolidate planning docs under plans 2026-03-30 15:56:47 +08:00
windows Add desktop background-run lifecycle hooks 2026-03-26 18:42:11 +08:00
.gitignore chore: ignore golden failure artifacts 2026-04-10 11:21:40 +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 Clean bridge provider routing and refresh repo instructions 2026-04-12 14:09:25 +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
flutter_rust_bridge.yaml feat: integrate Codex CLI as built-in code agent 2026-03-14 00:10:27 +08:00
LICENSE Initial commit 2026-03-11 00:49:57 +08:00
Makefile feat(settings): refresh account sync, add about metadata, and rewrite task dialog modes 2026-04-13 18:02:30 +08:00
package.json Initial Flutter workspace shell 2026-03-11 07:32:52 +08:00
pubspec.lock Refactor bridge provider readiness and trim stale tests 2026-04-12 15:42:15 +08:00
pubspec.yaml Refactor bridge provider readiness and trim stale tests 2026-04-12 15:42:15 +08:00
README.md refactor: remove web surface from xworkmate-app 2026-04-09 11:19:40 +08:00

README.md

XWorkmate

XWorkmate is a Flutter-based AI workspace shell for running assistant threads, local or remote gateway tasks, and multi-agent collaboration in one app.

Project

XWorkmate combines a desktop-first Flutter app, persistent assistant task threads, and optional multi-agent orchestration. It is designed for users who want a single workspace for AI chat, gateway-backed execution, and packaged local tooling across macOS, Windows, Linux, iOS, and Android.

Companion Repository

The ACP Bridge Server and embedded Go helper now live in the standalone companion repository:

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

TL;DR

flutter pub get
flutter analyze
flutter test
flutter run -d macos

Xcode Run For macOS

XWorkmate only supports launching the macOS app from the workspace entrypoint:

open macos/Runner.xcworkspace

If you prefer a repo-native shortcut, run:

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. They appear in the workspace by design and are not app signing targets.

For release builds, archives, and packaging, continue to use:

flutter build macos
make build-macos

Downloads

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

All download buttons currently point to the latest GitHub release page.

Snapshots

Mobile Desktop
XWorkmate Mobile XWorkmate Desktop

Learn More