{"id":51413732,"url":"https://github.com/andrmaz/swarm","last_synced_at":"2026-07-04T17:01:11.855Z","repository":{"id":367371623,"uuid":"1223939633","full_name":"andrmaz/swarm","owner":"andrmaz","description":"Autonomous multi-agent system orchestrator for issues management","archived":false,"fork":false,"pushed_at":"2026-05-14T20:45:20.000Z","size":880,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-25T19:04:42.379Z","etag":null,"topics":["afk","mastra-ai","sandcastle"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andrmaz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-28T20:01:11.000Z","updated_at":"2026-05-14T20:47:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/andrmaz/swarm","commit_stats":null,"previous_names":["andrmaz/swarm"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/andrmaz/swarm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrmaz%2Fswarm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrmaz%2Fswarm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrmaz%2Fswarm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrmaz%2Fswarm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrmaz","download_url":"https://codeload.github.com/andrmaz/swarm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrmaz%2Fswarm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35129190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-04T02:00:05.987Z","response_time":113,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["afk","mastra-ai","sandcastle"],"created_at":"2026-07-04T17:01:10.848Z","updated_at":"2026-07-04T17:01:11.845Z","avatar_url":"https://github.com/andrmaz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Swarm\n\nWelcome to your new [Mastra](https://mastra.ai/) project! We're excited to see what you'll build.\n\n## Getting Started\n\nStart the development server:\n\n```shell\nnpm run dev\n```\n\nOpen [http://localhost:4111](http://localhost:4111) in your browser to access [Mastra Studio](https://mastra.ai/docs/studio/overview). It provides an interactive UI for building and testing your agents, along with a REST API that exposes your Mastra application as a local service. This lets you start building without worrying about integration right away.\n\nYou can start editing files inside the `src/mastra` directory. The development server will automatically reload whenever you make changes.\n\n## Learn more\n\nTo learn more about Mastra, visit our [documentation](https://mastra.ai/docs/). Your bootstrapped project includes example code for [agents](https://mastra.ai/docs/agents/overview), [tools](https://mastra.ai/docs/agents/using-tools), [workflows](https://mastra.ai/docs/workflows/overview), [scorers](https://mastra.ai/docs/evals/overview), and [observability](https://mastra.ai/docs/observability/overview).\n\nIf you're new to AI agents, check out our [course](https://mastra.ai/learn) and [YouTube videos](https://youtube.com/@mastra-ai). You can also join our [Discord](https://discord.gg/BTYqqHKUrf) community to get help and share your projects.\n\n## GitHub Side-Project Workflow\n\nThis repo now includes a hybrid four-role GitHub delivery flow for personal side projects:\n\n- Product manager selects or creates the next GitHub issue in Mastra\n- Software architect turns that issue into an implementation plan in Mastra\n- Software engineer executes the plan in an isolated Sandcastle worktree / sandbox and opens a pull request\n- Code reviewer inspects the PR in an isolated Sandcastle run and submits the final GitHub review\n\nMastra owns orchestration, durable-ish workflow state, task progression, and GitHub coordination. Sandcastle owns isolated engineer / reviewer execution.\n\nThe orchestration is registered as `githubSideProjectWorkflow`, and the specialist agents are also available individually from `src/mastra/agents`.\n\n### GitHub credentials\n\nFor autonomous repository and pull request operations, set `GITHUB_TOKEN`.\n\nFor GitHub webhook / @mention handling through `@chat-adapter/github`, configure either:\n\n- `GITHUB_TOKEN` for the simplest personal-project setup, or\n- `GITHUB_APP_ID`, `GITHUB_PRIVATE_KEY`, and optionally `GITHUB_INSTALLATION_ID` for GitHub App mode\n\nWhen using GitHub webhooks, also set:\n\n- `GITHUB_WEBHOOK_SECRET`\n- `GITHUB_BOT_USERNAME`\n\n### Sandcastle setup\n\nTo run the engineer and reviewer stages, configure Sandcastle in `.env`:\n\n- Set `SANDCASTLE_PROVIDER` to `docker` or `podman`\n- Set `SANDCASTLE_IMAGE_NAME` to an image that has the tooling your target repos need\n- Set `SANDCASTLE_AGENT_PROVIDER` and `SANDCASTLE_AGENT_MODEL`\n- Provide the matching API key such as `ANTHROPIC_API_KEY` or `OPENAI_API_KEY`\n- Optionally set `SANDCASTLE_SANDBOX_READY_COMMANDS` for one-time sandbox bootstrapping like `pnpm install --frozen-lockfile`\n\nThe hybrid workflow writes Sandcastle logs under each target repo's `.sandcastle/logs/` directory.\n\nSee [docs/hybrid-architecture.md](docs/hybrid-architecture.md) for the full MVP architecture, required env vars, and an example workflow input.\n\n## Deploy to the Mastra platform\n\nThe [Mastra platform](https://projects.mastra.ai) provides two products for deploying and managing AI applications built with the Mastra framework:\n\n- **Studio**: A hosted visual environment for testing agents, running workflows, and inspecting traces\n- **Server**: A production deployment target that runs your Mastra application as an API server\n\nLearn more in the [Mastra platform documentation](https://mastra.ai/docs/mastra-platform/overview).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrmaz%2Fswarm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrmaz%2Fswarm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrmaz%2Fswarm/lists"}