What Is Mastra Factory (2026)? Open-Source Software Factory
By Antigravity Skills editorial team · Last updated
Short answer: Mastra Factory is an open-source "software factory" from the team behind the Mastra agent framework. You connect a GitHub repository, and coding agents move each issue through stages such as triage, plan, build and review until a pull request is ready for people to check. You can run it yourself or on Mastra's platform. The template's README says Apache-2.0.
Skill page: the agent skills for Mastra Factory have their own guide, Mastra Factory skills: install and use.
Unofficial guide. Antigravity Skills is not affiliated with Mastra. Every fact below comes from the Mastra Factory docs, the template-factory repository, Mastra's two launch posts and the Show HN thread, read on November 19, 2026. Numbers about how much work Factory does are Mastra's own claims about its own repositories. We did not run Factory. Confirm details on the official pages before relying on them.
What is Mastra Factory?
Two different things share the Mastra name, so keep them apart.
- Mastra is an open-source TypeScript framework for building AI agents and apps. It is the building block.
- Mastra Factory is an application built on top of that framework. One of its founders said on Hacker News that it is a departure from what they had done before, because it is an application on top of the primitives rather than the primitives themselves.
The README describes Factory as an open-source environment for building software with coding agents: connect a repository and issues become plans, implementations and reviewed pull requests. In the Show HN post, the team describes it as a configurable agentic kanban board that you can tag in Slack. It is the system Mastra built to help maintain Mastra itself.
Mastra announced it on July 27, 2026, and published a beta post on September 8, 2026. Neither post, nor the docs landing page, mentions pricing.
How Mastra Factory works
According to the beta post, the board runs through Intake, Triage, Planning, Build, Review and Done. Each stage can run manually or automatically, and agents work in sandboxed environments. Pieces named in the sources:
- Intake: work comes from GitHub issues, and optionally Linear, Jira or Slack. Each teammate picks their own issue sources.
- Sessions: every work item opens as an agent session you can watch, including edits and checks.
- Approvals: the docs treat accepting a task, approving a plan and merging a pull request as three separate decisions.
- Review items: each pull request gets its own review card and review session.
- Knowledge: a wiki with source citations, kept up to date by a curator agent, so agents can use company knowledge. Mastra says it plans to release this as a standalone piece.
- Signals: a way to steer running work, such as pull request comments feeding into a session.
- Sandboxes: the platform's cloud sandboxes, local execution, or another sandbox provider.
The Show HN post adds that it uses Mastra's durable agents for long-running sessions and its conversational memory.
Mastra Factory vs. Mastra the framework
This table is our own breakdown of what the sources say. "Not stated" means we found nothing in the sources we read.
| Mastra (framework) | Mastra Factory | |
|---|---|---|
| What it is | TypeScript framework for building agents and apps | An app that runs coding agents over your repository |
| Repository | mastra-ai/mastra | mastra-ai/template-factory |
| License | Apache 2.0, except directories named ee/, which have a separate license (per its LICENSE file) | Apache-2.0 (per the template README) |
| Who it is for | Developers building their own agent products | Teams that want agents to work on their own repositories |
| Pricing | Not covered by this page | Not stated in the launch posts or on the docs landing page |
| Hosted option | Not covered by this page | Mastra platform (the Show HN post says a hosted version exists) |
What Mastra says it achieves
| Claim | Source | Our status |
|---|---|---|
| Factory authored 25-35% of Mastra's pull requests and closed 50-60% of issues since the July alpha | Beta post | Self-reported; the post's own charts show 277 of 1,627 merged PRs (17.0%) and 222 of 778 closed issues (28.5%) |
| Last week Factory opened and merged 238 PRs, alongside 630 merged by humans | Show HN post | Self-reported; not checked |
| Nearly 4M downloads per week for Mastra | Show HN post | Vendor figure, about the framework, not Factory |
| Open source | README, docs | Repository is public and the README says Apache-2.0; GitHub's license field for it was empty when we looked |
| Fully automatic runs are not a safe default | Beta post | Mastra reports automatic mode caused problems, so each stage became configurable |
How to get started
This summarizes the official instructions. We have not run them.
- Scaffold the project. Run
npm create factory@latest <name>in a directory separate from the repository you want agents to change. The README saysnpm create factory -- --no-platformgives the self-hosted template instead. - Set a credential key. The scaffold generates
FACTORY_CREDENTIAL_ENCRYPTION_KEY, which encrypts stored model keys and integration secrets. If it is missing, generate one withopenssl rand -base64 32and keep a backup. - Start the server.
npm run dev, then open the local URL it prints. - Connect a repository and a model. The onboarding wizard asks for the repository, a GitHub App grant and a model provider.
- Turn on intake. In Settings, Work Intake, enable GitHub issue sync for your repository.
- Try one small issue. Find it under Work, Intake, choose Investigate, review the plan, then review the pull request and merge it your normal way.
Requirements the README lists: a Node.js version matching the project's engines setting, a PostgreSQL database with pgvector, a GitHub repository with a GitHub App installed, and a model provider. The default setup uses Mastra platform sign-in and sandboxes; self-hosting means supplying your own authentication, storage and sandbox. Slack is bundled but stays off until you set its credentials.
Factory is not a coding agent you install into your editor. For that, see our guide to installing skills in Antigravity, Claude Code and Codex.
What Hacker News commenters raised
The Show HN thread had about 70 points when we read it, with nine top-level replies. Paraphrasing the useful parts:
- One commenter asked whether agents act as the engineer or as their own identity. A Mastra team member replied that the default is a GitHub App called "Mastra Platform", and that setting a personal access token lets the agent open pull requests on a user's behalf.
- Another commenter noted the project closed its repository to outside contributors. A co-founder said they now prefer detailed issue write-ups, a trend they see across open source. A third commenter welcomed it; another maintainer warned that AI-written issues can be low-value too.
- One reader said the page needs more visuals, because the audience may not be developers. A team member pointed to a recorded workshop; a shorter demo was promised.
- One commenter predicted Mastra would be swallowed by bigger AI labs. The team answered that it is open source and has heard that for 15 months.
Caveats and open questions
- Results are self-reported. The headline numbers describe Mastra's own repositories and workflow. Your repo, tests and review habits will differ.
- Automation needs gates. Mastra says bulk backlog imports strained infrastructure and produced work that was hard to review, and that a wrong assumption early on (a triage agent misjudging revenue impact) led to pull requests being closed.
- It acts on your repository. Factory holds GitHub and model credentials. Read the permissions you grant, and start with a test repository.
- Factory does not re-check after merge. The docs say it does not reassess a task once its pull request merges, so check acceptance criteria before merging. A task may need several pull requests.
- License details. The docs landing page links to a license page we did not open. The README says Apache-2.0, but GitHub showed no license field for the repository.
- Young and moving fast. The template repository was created October 27, 2026 and had 15 stars when we looked. The sources do not list a stable release.
- Not in our sources: pricing for the hosted version, usage limits, or an independent review.
Where it fits with other agent tools
Factory sits above coding agents and below your review process: it orchestrates work, you still approve plans and merges. Compare it with Coral, an open-source gateway that controls which systems an agent may touch, and OpenClaw, a self-hosted personal assistant. For skills that change how an agent works, see gstack, where agents look for skills on GitHub, or the Antigravity Skills library. We do not rank Factory against other agent kanban or coding-agent tools, because the sources contain no comparison.
FAQ
What is Mastra Factory?
An open-source software factory from the Mastra team. It connects to a GitHub repository and uses coding agents to move issues through triage, planning, building and review, with approvals you configure.
Is Mastra Factory free and open source?
The template README says Apache-2.0. Pricing for the hosted Mastra platform is not stated in the pages we read, and running it needs your own model provider and a PostgreSQL database.
Is Mastra Factory the same as Mastra?
No. Mastra is the TypeScript agent framework. Factory is an application built on it, in a separate repository.
How do I install Mastra Factory?
Run npm create factory@latest in a folder separate from your target repository, then follow the onboarding. Details are in the sections above and the official docs.
Related on Antigravity Skills
- How to install skills in Antigravity, Claude Code and Codex
- Coral: the open-source gateway for AI agents
- OpenClaw: the self-hosted AI agent
- gstack
- All skills