mastra-aimastra-ai/mastra/mastracode/AGENTS.md

mastra / mastracode

AGENTS.md29k starsChanged 14 days agoLicence not identifiedView on GitHub

Packages: mastracode/sdk (@mastra/code-sdk), mastracode/tui (mastracode), mastracode/factory-ui (@internal/factory-ui), and standalone mastracode/web. Scope commands to the changed package. TUI: build deps with pnpm build:mastracode; test SDK+TUI with pnpm test:mastracode; typecheck with pnpm…

We split this AGENTS.md into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

The licence could not be identified — read it at the source. We count its rules but don't quote them. Read them on GitHub.

≈ “Common” is an estimate: at least 1 in 5 of the 36,368 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Mar 8, 2025Tool calling in streams — sgomez/ollama-ai-provider15 reactions · 7 comments
Jul 11, 2025Add instrumentation for `mastra` — getsentry/sentry-javascript11 reactions · 2 comments
Mar 14, 2025feat (provider/amazon-bedrock): support AWS credential providers — vercel/ai7 reactions · 2 comments
May 14, 2025Tool call result not implemented? — ag-ui-protocol/ag-ui5 reactions · 2 comments
Sep 22, 2026IPI-1300 · Make every iPix AI feature follow one safe review-to-write lifecycle — amoai-tech/ipixai4 reactions · 14 comments

45 more on GitHub

Sep 13, 2026IPI-1081 · PLAN-001 — Turn a Shoot Brief Into One Complete Reviewable Shoot Plan — amoai-tech/ipixai4 reactions · 20 comments
Oct 12, 2025No text generated when using tools — opencomp-eu/ollama-ai-provider-v24 reactions · 10 comments
Jun 27, 2025support agui protocol — langgenius/dify4 reactions · 3 comments
Sep 22, 2026IPI-1306 · RUN-CTRL-001 — Stop the right Planner run from any Next instance — amoai-tech/ipixai3 reactions · 12 comments
Sep 22, 2026IPI-1299 · DOC-ARCH-001 — Make one verified platform architecture the iPix source of truth — amoai-tech/ipixai3 reactions · 11 comments
Sep 21, 2026Archived Planner tenant-isolation proof — superseded by merged PR #198 — amoai-tech/ipixai3 reactions · 5 comments
Sep 18, 2026IPI-1233 · Show the AI Shoot Plan as a Readable Production Card That Survives Reload — amoai-tech/ipixai3 reactions · 19 comments
Sep 18, 2026IPI-1232 · MASTRA-DEV-SEC-001 — Keep the local Mastra agent private to this computer — amoai-tech/ipixai3 reactions · 6 comments
Sep 18, 2026SAN-1321 · Make new environments create the same Mastra database as production — amoai-tech/mdeai3 reactions · 15 comments
Sep 18, 2026IPI-1229 · VERCEL-OPT-001 — Stop normal pages loading AI runtime and shrink Vercel bundles — amoai-tech/ipixai3 reactions · 12 comments
Sep 18, 2026SAN-1314 · Keep MDE production online when env, auth, or runtime config changes — amoai-tech/mdeai3 reactions · 7 comments
Sep 18, 2026IPI-1217 · COPILOT-APP-DOCK-002 — Prove one organization cannot read or restore another organization’s Planner chat — amoai-tech/ipixai3 reactions · 17 comments
Sep 16, 2026SAN-1274 PR 1 — Add the verified MDE AI skills foundation — amoai-tech/mdeai3 reactions · 5 comments
Sep 15, 2026Make iPix Pick the Right Shoot References for Each Product and Prove It Works in /app — amoai-tech/ipixai3 reactions · 9 comments
Sep 14, 2026IPI-1211 · PLANNER-RELIABILITY — Upgrade the Mastra Bridge to 1.1.4 Before Re-Testing Intelligence — amoai-tech/ipixaisays it tested it3 reactions · 11 comments
Sep 7, 2026IPI-1164 · MEM-001 — Enable generateTitle for Planner Threads — amoai-tech/ipixai3 reactions · 9 comments
Jan 31, 2026OpenRouter免费模型工具调用失败：404 No endpoints found that support tool use — openclaw/openclaw3 reactions · 2 comments
Oct 26, 2026Fix Ask MDE chat failures from malformed Gemini tool calls (safe one-time retry) — amoai-tech/mdeai2 reactions · 13 comments
Oct 14, 2026Stop Concierge filesystem errors on Vercel without enabling file writes — amoai-tech/mdeai2 reactions · 14 comments
Oct 5, 2026Upgrade Mastra to one coherent family without breaking chat, memory, or workflows — amoai-tech/mdeai2 reactions · 32 comments
Sep 27, 2026IPI-1332 · MASTRA-UPG-005 — Prepare the Database for Mastra 1.71 (PR A · Approval Required) — amoai-tech/ipixai2 reactions · 8 comments
Sep 19, 2026SAN-1332 · Stop PR-Agent from blocking valid framework code with unsupported API claims — amoai-tech/mdeai2 reactions · 12 comments
Sep 18, 2026IPI-1231 · VERCEL-RUNTIME-001 — Stop Vercel builds from loading Mastra database secrets before runtime — amoai-tech/ipixai2 reactions · 9 comments
Sep 18, 2026chore(deps): bump the npm-production group with 24 updates — ComposioHQ/composio2 reactions · 5 comments
Sep 18, 2026IPI-1084 · Record exactly which Shoot Plan revision the operator approved — amoai-tech/ipixai2 reactions · 10 comments
Sep 15, 2026IPI-1208 · PLANNER-TOOLGATE-001 — Keep Shoot Planning From Triggering Brand Changes — amoai-tech/ipixai2 reactions · 13 comments
Sep 13, 2026IPI-1200 · PR-REVIEW-V2-001 — Catch Risky iPix Code Changes Automatically Before Merge — amoai-tech/ipixai2 reactions · 13 comments
Sep 11, 2026IPI-1093 · BRAND-INTEL-001 — Make AI Brand Profiles Safe to Review, Approve, and Resume — amoai-tech/ipixai2 reactions · 6 comments
Aug 21, 2026IPI-1020 · COPILOT-PERSIST-001 — Preserve iPix AI Conversations Across Refreshes, Restarts, and Cloudflare Isolates — amo-tech-ai/lumina-studio2 reactions · 8 comments
Aug 16, 2026IPI-1011 · MASTRA-PG-015 — Clarify the Emergency Mastra Rollback: Set MASTRA_SCHEMA=public Before Rollback — amo-tech-ai/lumina-studio2 reactions · 6 comments
Jun 23, 2026Add sql-optimization-patterns skill — Kilo-Org/kilo-marketplace2 reactions · 1 comment
Jun 23, 2026Add kpi-dashboard-design skill — Kilo-Org/kilo-marketplace2 reactions · 1 comment
Jun 23, 2026Add airflow-dag-patterns skill — Kilo-Org/kilo-marketplace2 reactions · 1 comment
Jan 21, 2026Bump tar, @mastra/core and mastra in /hyperai — GlacierEQ/lumoshy2 reactions · 5 comments
Jan 17, 2026Bump tar, @mastra/core and mastra in /hyperai — GlacierEQ/lumoshy2 reactions · 6 comments
Dec 3, 2025Bun does not respect deprecated on npm with "bad publish" — oven-sh/bun2 reactions · 2 comments
Nov 18, 2025Open Source Friday - Mastra - 03-20-2026 — githubevents/open-source-friday2 reactions · 6 comments
Sep 3, 2026Better Auth declarations fail with `skipLibCheck: false` — better-auth/better-auth1 reaction
Aug 31, 2026Bump jsondiffpatch, @ag-ui/mastra and @mastra/client-js — ovabor/worksync-frontend1 reaction · 2 comments
Aug 24, 2026chore(deps): bump the mastra group across 1 directory with 3 updates — omerakben/omer-akben1 reaction · 2 comments
Aug 12, 2026MCP OAuth loopback redirect uses 127.0.0.1 instead of localhost — breaks providers (e.g. Salesforce) that only allow localhost callback URLs — anthropics/claude-code1 reaction · 8 comments
Jul 10, 2026Instance AI (self-hosted preview): N8N_INSTANCE_AI_MODEL_URL ignored for openai provider; reasoning models fail on multi-step turns ("message provided without required reasoning item") — n8n-io/n8n1 reaction · 4 comments
May 11, 2026build(deps): bump @opentelemetry/auto-instrumentations-node, @mastra/client-js, @mastra/core, @mastra/evals, @mastra/langfuse, @mastra/libsql, @mastra/loggers, @mastra/mcp, @mastra/memory, @mastra/pg, @mastra/rag, @mastra/voice-google, @mastra/voice-google-gemini-live and mastra — cicero-im/deep-research-mastra1 reaction · 1 comment
May 11, 2026build(deps): bump @opentelemetry/exporter-prometheus, @mastra/client-js, @mastra/core, @mastra/evals, @mastra/langfuse, @mastra/libsql, @mastra/loggers, @mastra/mcp, @mastra/memory, @mastra/pg, @mastra/rag, @mastra/voice-google, @mastra/voice-google-gemini-live and mastra — cicero-im/deep-research-mastra1 reaction · 1 comment
Jan 17, 2026[BUG] Postiz fails due to missing Temporal — kossakovsky/selfhost-ai1 reaction · 10 comments

On Bluesky · 42

Nov 23, 2024🔥 Hot Repo！ 🔥 (100+ new stars) 📦 mastra-ai / mastra ⭐ 568 (+113) 🗒 TypeScript The TypeScript AI framework. — @github-trending-js.bsky.social8 likes and reposts · 1 reply
Oct 28, 2025«Mastra» The TypeScript AI agent framework. Assistants, RAG, observability. Supports any LLM: GPT-4, Claude, Gemini, Llama. →… — @remvze.bsky.social5 likes and reposts
Nov 21, 2024Let's build together. See you on Github :) github.com/mastra-ai/ma... — @calcsam.bsky.social5 likes and reposts
May 28, 2026📦 mastra-ai / mastra ⭐ 24,453 (+71) 🗒 TypeScript From the team behind Gatsby, Mastra is a framework for building AI-powered applications… — @github-trending-js.bsky.social3 likes and reposts
Jan 21, 2026🚀 Skyrocketing！ 🚀 (200+ new stars) 📦 mastra-ai / mastra ⭐ 19,787 (+409) 🗒 TypeScript From the team behind Gatsby, Mastra is a framework… — @github-trending-js.bsky.social3 likes and reposts

37 more on Bluesky

Feb 20, 2025🎉 Celebrating！ 🎉 (500+ new stars) 📦 mastra-ai / mastra ⭐ 2,360 (+748) 🗒 TypeScript the TypeScript AI agent framework — @github-trending-js.bsky.social3 likes and reposts · 1 reply
Nov 22, 2024Repo: github.com/mastra-ai/ma... — @sungkim.bsky.social3 likes and reposts
Aug 25, 2026📦 mastra-ai / mastra ⭐ 27,452 (+33) 🗒 TypeScript Mastra is the modern TypeScript framework for AI-powered applications and agents. — @github-trending-js.bsky.social2 likes and reposts
Aug 14, 2026Mastra is a TypeScript framework for building AI-powered applications and agents, from mastra-ai. Worth a look if you would rather keep… — @agentwire.fyi2 likes and reposts
Feb 8, 2026⭐️🔗 GitHub github.com/mastra-ai/ma... 👉 Discuss with me in Discord: linktr.ee/qdrddr — @qdrddr.bsky.social2 likes and reposts
Oct 10, 2025⚙️ Mastra — framework TypeScript open-source untuk membangun agen AI & workflow pintar! 🧠 Fitur: integrasi model LLM (OpenAI, Claude,… — @its-me-rhk.bsky.social2 likes and reposts
Sep 7, 2025📦 mastra-ai / mastra ⭐ 16,345 (+31) 🗒 TypeScript The TypeScript AI agent framework. ⚡ Assistants, RAG, observability. Supports any LLM:… — @github-trending-js.bsky.social2 likes and reposts
Apr 28, 2025GitHub - mastra-ai/mastra: The TypeScript AI agent framework. ⚡ Assistants, RAG, observability. Supports any LLM: GPT-4, Claude, Gemini,… — @geshan.com.np2 likes and reposts
Apr 21, 2025📦 mastra-ai / mastra ⭐ 12,246 (+92) 🗒 TypeScript The TypeScript AI agent framework. ⚡ Assistants, RAG, observability. Supports any LLM:… — @github-trending-js.bsky.social2 likes and reposts
Mar 23, 2025https://github.com/mastra-ai/mastra mastra-ai/mastra: The TypeScript AI agent framework. ⚡ Assistants, RAG, observability. Supports any… — @yug1224.com2 likes and reposts
Mar 17, 2025🔥 Hot Repo！ 🔥 (100+ new stars) 📦 mastra-ai / mastra ⭐ 10,590 (+119) 🗒 TypeScript The TypeScript AI agent framework. ⚡ Assistants, RAG,… — @github-trending-js.bsky.social2 likes and reposts
Mar 15, 2025🛠️ Mastra 👉🏻 A TypeScript framework for building AI apps that provides tools for workflows, agents, RAG, integrations, and evals. 👉🏻… — @mokkapps.de2 likes and reposts
Mar 5, 2025github.com/mastra-a... GitHub - mastra-ai/mastra: The TypeScript AI agent framework. ⚡ Assistants... -… — @technews4869.bsky.social2 likes and reposts
Feb 26, 2025mastra-ai/mastra: The TypeScript AI agent framework. ⚡ Assistants, RAG, observability. Supports any LLM: GPT-4, Claude, Gemini, Llama. — @fluid.sublimer.me2 likes and reposts
Feb 23, 2025Mastra Unleashed: A New Open-Source JS Agent Framework Discover a cutting-edge JavaScript framework that powers agent-based development. — @gigrdo.bsky.social2 likes and reposts
Nov 30, 2024This looks very promising. And not just because it's typescript ;) — @u11g.com2 likes and reposts
Jul 19, 2026https://github.com/mastra-ai/mastra — @sigmanor.net1 likes and repost
Jun 1, 2026🚀 GitHub Intelligence Drop sdk-typescript (TypeScript • 🟢) ⭐ 699 → https://github.com/strands-agents/sdk-typescript mastra (TypeScript •… — @githubfeed.bsky.social1 likes and repost
Apr 2, 2026Si quieres ir en serio con agentes IA y ya trabajas con TypeScript, este repo te ahorra semanas. github.com/mastra-ai/m... — @josusanz.bsky.social1 likes and repost
Jan 23, 2026今日のGitHubトレンド mastra-ai/mastra Mastraは、TypeScriptを用いたAIアプリケーションやエージェントを構築するためのフレームワークです。… — @dailygithubtrends.bsky.social1 likes and repost
Jan 22, 2026🚀 Skyrocketing！ 🚀 (200+ new stars) 📦 mastra-ai / mastra ⭐ 19,998 (+460) 🗒 TypeScript From the team behind Gatsby, Mastra is a framework… — @github-trending.bsky.social1 likes and repost
Jan 20, 2026Show HN: Mastra 1.0, open-source JavaScript agent framework from the Gatsby devs | Discussion — @hackernewsbot.bsky.social1 likes and repost
Jan 20, 2026Ever imagined giving your JavaScript apps more intelligent capabilities? Mastra 1.0, an open-source agent framework from the Gatsby team,… — @tickfoundry.com1 likes and repost
Jan 20, 2026Show HN: Mastra 1.0, open-source JavaScript agent framework from the Gatsby devs L: https://github.com/mastra-ai/mastra C:… — @hnws.bsky.social1 likes and repost
Jan 20, 2026Show HN: Mastra 1.0, open-source JavaScript agent framework from the Gatsby devs Discussion — @hn100.bsky.social1 likes and repost
Jul 11, 2025📦 mastra-ai / mastra ⭐ 14,905 (+53) 🗒 TypeScript The TypeScript AI agent framework. ⚡ Assistants, RAG, observability. Supports any LLM:… — @github-trending-js.bsky.social1 likes and repost
Feb 24, 2025💎 Hidden Gem！ 💎 (1000+ new stars) 📦 mastra-ai / mastra ⭐ 5,847 (+1,197) 🗒 TypeScript the TypeScript AI agent framework — @github-trending-js.bsky.social1 likes and repost · 1 reply
Feb 23, 2025今日のGitHubトレンド mastra-ai/mastra Mastraは、AIアプリケーションを迅速に構築するためのTypescriptフレームワークです。ワークフロー、エージェント、RAG、統合、評価など、AI開発に必要な基本機能を提供します。… — @dailygithubtrends.bsky.social1 likes and repost
Feb 21, 2025今日のGitHubトレンド mastra-ai/mastra Mastraは、AIアプリケーションを迅速に構築するためのTypescriptフレームワークです。… — @dailygithubtrends.bsky.social1 likes and repost
Feb 20, 2025🎉 Celebrating！ 🎉 (500+ new stars) 📦 mastra-ai / mastra ⭐ 2,360 (+748) 🗒 TypeScript the TypeScript AI agent framework — @github-trending.bsky.social1 likes and repost · 1 reply
Feb 19, 2025Show HN: Mastra – Open-source JS agent framework, by the developers of Gatsby (@github.com) Main Link | Discussion — @newsycombinator.bsky.social1 likes and repost
Feb 19, 2025Show HN: Mastra – open-source TypeScript agent framework https://github.com/mastra-ai/mastra (https://news.ycombinator.com/item?id=43103073) — @betterhn20.e-work.xyz1 likes and repost
Jan 22, 2025github.com/mastra-a... GitHub - mastra-ai/mastra: The TypeScript AI framework. — @technews4869.bsky.social1 likes and repost
Nov 24, 2024github.com/mastra-a... yug1224 starred mastra-ai/mastra — @yug1224.com1 likes and repost
Feb 24, 2025💎 Hidden Gem！ 💎 (1000+ new stars) 📦 mastra-ai / mastra ⭐ 5,847 (+1,197) 🗒 TypeScript the TypeScript AI agent framework — @github-trending.bsky.social0 likes and reposts · 1 reply
Feb 20, 2025Show HN: Mastra - Gatsbyの開発者によるオープンソースのJSエージェントフレームワーク Show HN: Mastra – Open-source JS agent framework, by the developers of Gatsby 🔺 369… — @hacker-news-jp.bsky.social0 likes and reposts · 1 reply
Feb 3, 2025Have you tried Mastra? github.com/mastra-ai/ma... — @calcsam.bsky.social0 likes and reposts · 1 reply

On YouTube · 15

Feb 27, 2025Mastra Demo - The Typescript AI Agent Framework (2024) — Mastra45k views · 97 comments
Jan 20, 2026Mastra 1.0 is here - Intro to Mastra (2025 product tour) — Mastra14k views · 11 comments
Oct 3, 2026Replay: Open Source Friday with Mastra — GitHub6.2k views · 1 comment
Apr 27, 2026Deploy a Mastra AI Agent to AWS in Minutes with Defang — Defang Software Labs5.7k views
Dec 3, 2025How to Build AI Workflows with Mastra and AI SDK (Full Tutorial) — Kristian4.9k views · 6 comments

10 more on YouTube

Mar 1, 2026How to Build Reliable AI Agents with Datasets, Experiments, and Error Analysis — Mastra1.5k views · 3 comments
Mar 21, 2026Open Source Friday with Mastra — GitHub1.5k views
Jun 22, 2026One framework. All you AI. — WEBdoze801 views
Jan 21, 2026Mastra v1.0: The Biggest Update Yet (Features + Migration) — Kristian647 views · 6 comments
Sep 23, 2026Mastra: Build Your Own AI Shop Assistant — Tech Lead Corner212 views
Oct 3, 2026Replay: Open Source Friday with Mastra — Andrea Griffiths166 views
Feb 19, 2025GitHub - mastra-ai/mastra: the TypeScript AI agent framework — GitHub Daily Trend AI Podcast159 views
Mar 21, 2026Open Source Friday with Mastra — Andrea Griffiths42 views
Oct 14, 2026Build an AI Agent That Answers Customer Questions by Afternoon: Mastra #Shorts — Skynetlabs25 views
Oct 14, 2026One Email or Two? Testing Mastra's Crash Recovery (50 Real Runs) — Agentic Engineeringsays it tested it4 views

On Hacker News · 5

Feb 19, 2025Show HN: Mastra – Open-source JS agent framework, by the developers of Gatsby442 points · 154 comments
Jan 20, 2026Show HN: Mastra 1.0, open-source JavaScript agent framework from the Gatsby devs213 points · 70 comments
Aug 6, 2025Show HN: Principles of Building AI Agents book [pdf]5 points
Jun 17, 2026Multiple mastra NPM packages compromised4 points · 1 comment
Jan 24, 2026Agent Skills Support in Mastra2 points

Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 28,693 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository27 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/AGENTS.mdAGENTS.md
- examples/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- docs/CLAUDE.mdCLAUDE.md
- label-core-bugsSkill
- real-world-testingSkill
- testing-core-processorsSkill
- builder-smoke-testSkill
- debugging-difficult-bugsSkill
- docs-auditSkill
- docs-diagramsSkill
- e2e-tests-studioSkill
- label-core-bugsSkill
- live-mastracode-instrumentationSkill
- mastra-docsSkill
- mastra-frontendSkill
- mastra-smoke-testSkill
- playground-msw-testsSkill
- pr-explainerSkill
- pr-splitterSkill
- ralph-planSkill
- react-best-practicesSkill
- smoke-testSkill
- tailwind-v4Skill
- testing-core-processorsSkill
- testing-mastracode-tuiSkill

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free