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.
653 Commits 17 Branches 3 Tags 13 MiB
Dart 90.8%
Shell 4.2%
C++ 2%
Swift 0.9%
CMake 0.8%
Other 1.2%
c30c944e08
Go to file
Haitao Pan c30c944e08 Fix settings save wiring
2026-04-19 20:09:21 +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(aris): remove legacy ARIS assets and clean up associated code 2026-04-17 18:07:04 +08:00
config refactor(bridge): implement Single Source of Truth for bridge config and fix login persistence 2026-04-19 12:22:02 +08:00
docs Refine account sync bridge state model 2026-04-19 19:42:00 +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 Fix settings save wiring 2026-04-19 20:09:21 +08:00
linux Add desktop background-run lifecycle hooks 2026-03-26 18:42:11 +08:00
macos refactor(storage): unify persistent storage with robust error handling and simplified secret management 2026-04-19 10:34:15 +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(build): improve macOS packaging reliability and clean up Rust FFI 2026-04-19 15:00:34 +08:00
scripts fix(build): improve DMG styling stability and Finder volume discovery 2026-04-19 15:21:58 +08:00
test Fix settings save wiring 2026-04-19 20:09:21 +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 fix(build): ensure macOS packaging builds native dependencies and universal FFI binary 2026-04-18 17:06:34 +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 fix(build): improve macOS packaging reliability and clean up Rust FFI 2026-04-19 15:00:34 +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 chore(aris): remove legacy ARIS assets and clean up associated code 2026-04-17 18:07:04 +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