XWorkmate is a Flutter-based AI workspace shell for running assistant threads, local or remote gateway tasks, and multi-agent collaboration in one app.
| .codex | ||
| .github | ||
| android | ||
| assets | ||
| config | ||
| docs | ||
| go/aris_bridge | ||
| integration_test | ||
| ios | ||
| lib | ||
| linux | ||
| macos | ||
| packaging/windows | ||
| releases/v0.5 | ||
| rust | ||
| scripts | ||
| test | ||
| test_driver | ||
| tool | ||
| vendor | ||
| web | ||
| windows | ||
| .gitignore | ||
| .gitmodules | ||
| .metadata | ||
| AGENTS.md | ||
| analysis_options.yaml | ||
| CHANGELOG.md | ||
| dart_test.yaml | ||
| flutter_rust_bridge.yaml | ||
| LICENSE | ||
| Makefile | ||
| package.json | ||
| pubspec.lock | ||
| pubspec.yaml | ||
| README.md | ||
XWorkmate
XWorkmate is an AI workspace shell built with Flutter.
v0.5 ships persistent assistant task threads, optional ARIS-powered multi-agent collaboration, and a bundled Go bridge runtime that travels with the macOS app.
v0.5 Highlights
- Assistant 任务线程支持流式回复、继续追问和手动归档，不再是一问一答即结束。
- 任务列表按
仅 AI Gateway / 本地 OpenClaw Gateway / 远程 OpenClaw Gateway分组显示。 - Multi-Agent 协作支持
Architect / Engineer / Tester，并可切换Native / ARIS框架。 - ARIS
skills/直接随 App 内置，llm-chat与claude-review统一由 Go bridge 驱动。 Ollama Cloud设置、ARIS helper bundling、macOS DMG 打包与安装链路已打通。
Current Scope
Shipping in v0.5
- AI Gateway-only streaming assistant threads
- OpenClaw local/remote task threads with persistent context
- Multi-Agent orchestration with optional ARIS preset
- Bundled ARIS skills, Go bridge helper,
llm-chatreviewer, andclaude-review - Ollama Cloud settings, task grouping, and macOS packaged delivery
- Flutter Web shell with
Assistant+Settingsonly, supportingDirect AI GatewayandRelay OpenClaw Gateway
Not Yet Implemented
- Built-in Codex runtime through Rust FFI
- Distributed/headless remote worker orchestration
- Generic external Code Agent provider chooser / scheduler UI beyond current role-based settings
- Expanded task CRUD beyond the current assistant-thread-first workflow
- Expanded memory APIs beyond
memory/sync
Feature Planning
- Source of truth: config/feature_flags.yaml
- UI feature matrix: docs/planning/xworkmate-ui-feature-matrix.md
- Release roadmap: docs/planning/xworkmate-ui-feature-roadmap.md
- Release notes: docs/releases/xworkmate-release-notes.md
- Changelog: docs/releases/xworkmate-changelog.md
- Render command:
make render-release-docs
Known Issues
- ARIS local-first collaboration still depends on a reachable local Ollama endpoint for the strongest offline workflow.
- Cloud CLI roles still degrade to locally available executors when Gemini / Claude / Codex are not installed.
- Manual validation is still recommended for full end-to-end multi-agent runs that touch external CLIs.
Development
flutter analyze
flutter test
flutter test --platform chrome test/widget_test.dart test/web
flutter run -d macos
Flutter Web
Web keeps the Assistant-first entry flow, but only exposes:
AssistantSettingsDirect AI GatewayRelay OpenClaw Gateway
Web does not expose local CLI, workspace file access, native runtime orchestration, or desktop-only diagnostics.
Build the root-site bundle with:
flutter build web --release --base-href /
Deployment notes for https://xworkmate.svc.plus/ are in docs/web-deployment.md.
macOS Packaging
make package-mac
make install-mac
Vendor Repositories
vendor/codex is tracked as a git submodule for future built-in code agent integration.
git submodule update --init --recursive