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.
571 Commits 17 Branches 3 Tags 13 MiB
Dart 90.8%
Shell 4.2%
C++ 2%
Swift 0.9%
CMake 0.8%
Other 1.2%
55a80d2891
Go to file
Haitao Pan 55a80d2891 Merge branch 'codex/bridge-only-routing-cleanup'
2026-04-11 13:50:19 +08:00
.github Fix release pipeline verification and latest release tagging 2026-04-11 10:31:15 +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 Hide experimental gateway modes by default 2026-04-09 09:30:54 +08:00
docs Enforce bridge-only production routing in app 2026-04-11 13:50:11 +08:00
images docs: simplify root readme 2026-03-26 09:49:58 +08:00
integration_test Refactor settings account login flow 2026-04-11 12:45:14 +08:00
ios fix: streamline gateway settings and mac packaging cleanup 2026-04-09 11:39:00 +08:00
lib Enforce bridge-only production routing in app 2026-04-11 13:50:11 +08:00
linux Add desktop background-run lifecycle hooks 2026-03-26 18:42:11 +08:00
macos chore: suppress noisy macos third-party build warnings 2026-04-11 09:28:00 +08:00
packaging/windows Add multi-platform build and release workflow 2026-03-21 10:08:12 +08:00
releases/v0.5 Split ACP bridge into standalone repository 2026-04-09 09:49:52 +08:00
rust fix: resolve Rust FFI compilation errors and simplify build 2026-03-14 09:52:13 +08:00
scripts Fix release pipeline verification and latest release tagging 2026-04-11 10:31:15 +08:00
test Enforce bridge-only production routing in app 2026-04-11 13:50:11 +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 chore: commit agents instruction updates and core functional test plan 2026-04-10 16:54:40 +08:00
analysis_options.yaml Fix macOS archive symbols and packaging settings 2026-03-27 16:32:23 +08:00
CHANGELOG.md release: prepare v0.7 2026-03-24 00:34:42 +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 test: add real env login chain checks 2026-04-10 10:18:46 +08:00
package.json Initial Flutter workspace shell 2026-03-11 07:32:52 +08:00
pubspec.lock build: add test-all make targets 2026-04-08 16:37:12 +08:00
pubspec.yaml merge: consolidate CI and thread binding branch work 2026-04-11 08:20:51 +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