Mastra Desktop

mastra-desktop is an experimental Electron desktop wrapper around Mastra-powered local workflows.

Status

This project is pre-alpha.

Expect rough edges, breaking changes, and incomplete features. This stage is aimed at developers and tech-savvy power users who want to kick the tires, test behavior, and contribute improvements.

Attribution and Disclaimer

This project is not connected with Mastra.ai. I'm a single developer building a desktop wrapper around Mastra.ai.

Mastra is an important technology dependency and the main inspiration for this work, especially Mastra.ai Studio.

Requirements

• Node.js 20+
• Yarn 4+
• API keys in a local .env file (TBC, should we have .env or store keys in the app?)

I'm developing this on macOS. Windows and Linux support is not yet planned.

Setup

1. Install dependencies:

yarn install

Development

Start the app in development mode:

yarn dev

This compiles TypeScript, starts Electron, and runs the Mastra runtime from src/mastra.

Build and Package

Build production output:

yarn build

Create a packaged build for local testing:

yarn dist

Current packaging is macOS-oriented (darwin + arm64) and should be treated as early-stage only.

Testing

Run unit tests:

yarn test:unit

Run end-to-end tests:

yarn test:e2e

Run focused Electron agent E2E:

yarn test:e2e:agent

Repository Layout

• src/: Electron main process and local orchestration code
• src/mastra/: Mastra agents/tools/workflow runtime wiring
• next-app/: web UI used in the desktop shell
• tests/: E2E and integration tests
• docs/: project-specific design and engineering notes

Public Roadmap

• Agents
• Assistants (harness)
• Memory (plugins)
• Tools (plugin factory)
  • Sandbox (local, plugins)
  • File uploads and document parsing
• Workflows
• UI awesomeness

Credits and Inspiration

• Mastra.ai Studio (main inspiration)
• OpenClaw
• Hermes Agent
• Open WebUI
• LibreChat
• Cherry Studio

Contributing

Contributions are welcome from developers and technical users testing pre-alpha builds.

See CONTRIBUTING.md for setup, process, and pull request expectations.

Security

Please do not report security issues in public issues. See SECURITY.md for responsible disclosure guidance.

Support

This project is pre-alpha and there is currently no end-user support. See SUPPORT.md for best-effort community support expectations.