{"id":29980402,"url":"https://github.com/mrz1836/mage-x","last_synced_at":"2026-02-18T06:02:25.451Z","repository":{"id":307790586,"uuid":"1024393395","full_name":"mrz1836/mage-x","owner":"mrz1836","description":"๐Ÿช„ Write Once, Mage Everywhere: Zero-Boilerplate Build Tooling for Go","archived":false,"fork":false,"pushed_at":"2026-02-16T16:06:18.000Z","size":18230,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-16T23:43:12.869Z","etag":null,"topics":["agentos","bmad","go","go-mage","golang","mage","mage-x","magex","sdd","speckit"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mrz1836.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":".github/AGENTS.md","dco":null,"cla":null},"funding":{"github":"mrz1836","custom":"https://mrz1818.com/?tab=tips\u0026utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=mage-x\u0026utm_term=mage-x\u0026utm_content=mage-x","buy_me_a_coffee":"mrz1818"}},"created_at":"2025-07-22T16:17:42.000Z","updated_at":"2026-02-16T16:06:18.000Z","dependencies_parsed_at":"2025-11-29T23:02:27.582Z","dependency_job_id":null,"html_url":"https://github.com/mrz1836/mage-x","commit_stats":null,"previous_names":["mrz1836/mage-x","mrz1836/go-mage"],"tags_count":160,"template":false,"template_full_name":null,"purl":"pkg:github/mrz1836/mage-x","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrz1836%2Fmage-x","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrz1836%2Fmage-x/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrz1836%2Fmage-x/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrz1836%2Fmage-x/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrz1836","download_url":"https://codeload.github.com/mrz1836/mage-x/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrz1836%2Fmage-x/sbom","scorecard":{"id":1238200,"data":{"date":"2025-09-26T18:06:20Z","repo":{"name":"github.com/mrz1836/mage-x","commit":"e911c2a9ac2fc4d57fd3bbcabc8f41e2fa7098de"},"scorecard":{"version":"v5.2.1","commit":"ab2f6e92482462fe66246d9e32f642855a691dc1"},"score":6.9,"checks":[{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: .github/SECURITY.md:1","Info: Found linked content: .github/SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: .github/SECURITY.md:1","Info: Found text in security policy: .github/SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#security-policy"}},{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#maintained"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#dependency-update-tool"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#binary-artifacts"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":10,"reason":"GitHub workflow tokens follow principle of least privilege","details":["Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql-analysis.yml:31","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:32","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/dependabot-auto-merge.yml:87","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress-coverage.yml:2324","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress-coverage.yml:2325","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress-coverage.yml:115","Warn: jobLevel 'statuses' permission set to 'write': .github/workflows/fortress-coverage.yml:119","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress-coverage.yml:120","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress-release.yml:59","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress-test-fuzz.yml:61","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress-test-matrix.yml:109","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress-test-suite.yml:176","Warn: jobLevel 'statuses' permission set to 'write': .github/workflows/fortress-test-suite.yml:180","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress-test-suite.yml:181","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress-test-validation.yml:49","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress-test-validation.yml:50","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:197","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:239","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:432","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress.yml:433","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:65","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:100","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:131","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:219","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress.yml:254","Warn: jobLevel 'statuses' permission set to 'write': .github/workflows/fortress.yml:258","Info: jobLevel 'actions' permission set to 'read': .github/workflows/fortress.yml:259","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:291","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:319","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/fortress.yml:423","Info: jobLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:119","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:86","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:254","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:339","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:432","Warn: jobLevel 'actions' permission set to 'write': .github/workflows/pull-request-management.yml:536","Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:537","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/pull-request-management.yml:639","Info: jobLevel 'contents' permission set to 'read': .github/workflows/sync-labels.yml:103","Info: topLevel 'contents' permission set to 'read': .github/workflows/auto-merge-on-approval.yml:39","Info: topLevel 'pull-requests' permission set to 'read': .github/workflows/auto-merge-on-approval.yml:40","Info: topLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:23","Info: topLevel 'contents' permission set to 'read': .github/workflows/dependabot-auto-merge.yml:35","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-benchmarks.yml:92","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-code-quality.yml:58","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-completion-finalize.yml:46","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-completion-finalize.yml:45","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-completion-report.yml:91","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-completion-report.yml:92","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-completion-statistics.yml:46","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-completion-statistics.yml:47","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-completion-tests.yml:44","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-completion-tests.yml:43","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-coverage.yml:57","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-coverage.yml:58","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-pre-commit.yml:46","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-release.yml:49","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-security-scans.yml:63","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-setup-config.yml:169","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-fuzz.yml:50","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-magex.yml:27","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-matrix.yml:99","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-suite.yml:113","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-test-suite.yml:114","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress-test-validation.yml:38","Info: topLevel 'actions' permission set to 'read': .github/workflows/fortress-test-validation.yml:39","Info: topLevel 'contents' permission set to 'read': .github/workflows/fortress.yml:48","Info: topLevel 'contents' permission set to 'read': .github/workflows/pull-request-management.yml:36","Info: topLevel 'contents' permission set to 'read': .github/workflows/scorecard.yml:23","Info: topLevel 'contents' permission set to 'read': .github/workflows/stale-check.yml:32","Info: topLevel 'contents' permission set to 'read': .github/workflows/sync-labels.yml:36"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":10,"reason":"all dependencies are pinned","details":["Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-benchmarks.yml:118","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-benchmarks.yml:180","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-benchmarks.yml:188","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-benchmarks.yml:264","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:171","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:181","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:249","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:391","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:434","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:464","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:608","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:673","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress-test-matrix.yml:740","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress.yml:140","Info: Possibly incomplete results: error parsing job operating system: .github/workflows/fortress.yml:167","Info: 67 out of 67 GitHub-owned GitHubAction dependencies pinned","Info: 5 out of 5 third-party GitHubAction dependencies pinned","Info: 1 out of 1 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#pinned-dependencies"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#license"}},{"name":"Fuzzing","score":10,"reason":"project is fuzzed","details":["Info: GoBuiltInFuzzer integration found: fuzz_test.go:5","Info: GoBuiltInFuzzer integration found: pkg/common/config/config_fuzz_test.go:18","Info: GoBuiltInFuzzer integration found: pkg/common/config/config_fuzz_test.go:186","Info: GoBuiltInFuzzer integration found: pkg/common/config/config_fuzz_test.go:309","Info: GoBuiltInFuzzer integration found: pkg/common/config/config_fuzz_test.go:435","Info: GoBuiltInFuzzer integration found: pkg/common/config/config_security_fuzz_test.go:151","Info: GoBuiltInFuzzer integration found: pkg/common/config/config_security_fuzz_test.go:258","Info: GoBuiltInFuzzer integration found: pkg/common/config/config_security_fuzz_test.go:358","Info: GoBuiltInFuzzer integration found: pkg/common/config/config_security_fuzz_test.go:458","Info: GoBuiltInFuzzer integration found: pkg/common/config/config_security_fuzz_test.go:629","Info: GoBuiltInFuzzer integration found: pkg/common/mockrec/helpers_test.go:229","Info: GoBuiltInFuzzer integration found: pkg/common/mockrec/helpers_test.go:247","Info: GoBuiltInFuzzer integration found: pkg/common/paths/security_fuzz_test.go:11","Info: GoBuiltInFuzzer integration found: pkg/common/paths/security_fuzz_test.go:92","Info: GoBuiltInFuzzer integration found: pkg/common/paths/security_fuzz_test.go:162","Info: GoBuiltInFuzzer integration found: pkg/common/paths/security_fuzz_test.go:255","Info: GoBuiltInFuzzer integration found: pkg/common/paths/security_fuzz_test.go:369","Info: GoBuiltInFuzzer integration found: pkg/mage/auto/register_comprehensive_test.go:843","Info: GoBuiltInFuzzer integration found: pkg/mage/auto/register_test.go:488","Info: GoBuiltInFuzzer integration found: pkg/mage/embed/commands_test.go:884","Info: GoBuiltInFuzzer integration found: pkg/mage/magefile_params_test.go:411","Info: GoBuiltInFuzzer integration found: pkg/mage/magefile_params_test.go:433","Info: GoBuiltInFuzzer integration found: pkg/mage/namespace_integration_test.go:537","Info: GoBuiltInFuzzer integration found: pkg/mage/registry_comprehensive_test.go:499","Info: GoBuiltInFuzzer integration found: pkg/security/command_fuzz_test.go:21","Info: GoBuiltInFuzzer integration found: pkg/security/command_fuzz_test.go:191","Info: GoBuiltInFuzzer integration found: pkg/security/command_fuzz_test.go:331","Info: GoBuiltInFuzzer integration found: pkg/security/command_fuzz_test.go:428","Info: GoBuiltInFuzzer integration found: pkg/security/validator_fuzz_test.go:16","Info: GoBuiltInFuzzer integration found: pkg/security/validator_fuzz_test.go:90","Info: GoBuiltInFuzzer integration found: pkg/security/validator_fuzz_test.go:168","Info: GoBuiltInFuzzer integration found: pkg/security/validator_fuzz_test.go:252","Info: GoBuiltInFuzzer integration found: pkg/security/validator_fuzz_test.go:336","Info: GoBuiltInFuzzer integration found: pkg/security/validator_fuzz_test.go:414","Info: GoBuiltInFuzzer integration found: pkg/security/validator_fuzz_test.go:442","Info: GoBuiltInFuzzer integration found: tests/integration/magex_params_e2e_test.go:84"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: SAST configuration detected: CodeQL","Info: all commits (3) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#sast"}},{"name":"Branch-Protection","score":4,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'master'","Info: 'force pushes' disabled on branch 'master'","Warn: 'branch protection settings apply to administrators' is disabled on branch 'master'","Warn: 'stale review dismissal' is disabled on branch 'master'","Warn: required approving review count is 1 on branch 'master'","Warn: codeowners review is not required on branch 'master'","Warn: 'last push approval' is disabled on branch 'master'","Warn: 'up-to-date branches' is disabled on branch 'master'","Info: status check found to merge onto on branch 'master'","Info: PRs are required in order to make changes on branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.7.0 not signed: https://api.github.com/repos/mrz1836/mage-x/releases/248128101","Warn: release artifact v1.6.9 not signed: https://api.github.com/repos/mrz1836/mage-x/releases/247748199","Warn: release artifact v1.6.8 not signed: https://api.github.com/repos/mrz1836/mage-x/releases/247712884","Warn: release artifact v1.6.6 not signed: https://api.github.com/repos/mrz1836/mage-x/releases/247134986","Warn: release artifact v1.6.5 not signed: https://api.github.com/repos/mrz1836/mage-x/releases/247132887","Warn: release artifact v1.7.0 does not have provenance: https://api.github.com/repos/mrz1836/mage-x/releases/248128101","Warn: release artifact v1.6.9 does not have provenance: https://api.github.com/repos/mrz1836/mage-x/releases/247748199","Warn: release artifact v1.6.8 does not have provenance: https://api.github.com/repos/mrz1836/mage-x/releases/247712884","Warn: release artifact v1.6.6 does not have provenance: https://api.github.com/repos/mrz1836/mage-x/releases/247134986","Warn: release artifact v1.6.5 does not have provenance: https://api.github.com/repos/mrz1836/mage-x/releases/247132887"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#signed-releases"}},{"name":"Contributors","score":3,"reason":"project has 1 contributing companies or organizations -- score normalized to 3","details":["Info: found contributions from: skyetel @bsv-blockchain @buxorg @bitcoinschema @tonicpow @bitcoin-sv"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#contributors"}},{"name":"CI-Tests","score":10,"reason":"3 out of 3 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#ci-tests"}}]},"last_synced_at":"2025-09-26T20:33:24.757Z","repository_id":307790586,"created_at":"2025-09-26T20:33:24.758Z","updated_at":"2025-09-26T20:33:24.758Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29569995,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T04:18:28.490Z","status":"ssl_error","status_checked_at":"2026-02-18T04:13:49.018Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["agentos","bmad","go","go-mage","golang","mage","mage-x","magex","sdd","speckit"],"created_at":"2025-08-04T14:10:43.094Z","updated_at":"2026-02-18T06:02:25.444Z","avatar_url":"https://github.com/mrz1836.png","language":"Go","funding_links":["https://github.com/sponsors/mrz1836","https://mrz1818.com/?tab=tips\u0026utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=mage-x\u0026utm_term=mage-x\u0026utm_content=mage-x","https://buymeacoffee.com/mrz1818","https://github.com/sponsors/mrz"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ๐Ÿช„\u0026nbsp;\u0026nbsp;MAGE-X\n\n\u003e **Write Once, Mage Everywhere: Zero-Boilerplate Build Tooling for Go.**\n\n\u003ca href=\"https://github.com/mrz1836/mage-x/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/release-pre/mrz1836/mage-x?include_prereleases\u0026style=flat-square\u0026logo=github\u0026color=black\" alt=\"Release\"\u003e\u003c/a\u003e\n\u003ca href=\"https://golang.org/\"\u003e\u003cimg src=\"https://img.shields.io/github/go-mod/go-version/mrz1836/mage-x?style=flat-square\u0026logo=go\u0026color=00ADD8\" alt=\"Go Version\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/mrz1836/mage-x/blob/master/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/mrz1836/mage-x?style=flat-square\u0026color=blue\" alt=\"License\"\u003e\u003c/a\u003e\n\n\u003cbr/\u003e\n\n\u003ctable align=\"center\" border=\"0\"\u003e\n \u003ctr\u003e\n \u003ctd align=\"right\"\u003e\n \u003ccode\u003eCI / CD\u003c/code\u003e \u0026nbsp;\u0026nbsp;\n \u003c/td\u003e\n \u003ctd align=\"left\"\u003e\n \u003ca href=\"https://github.com/mrz1836/mage-x/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/mrz1836/mage-x/fortress.yml?branch=master\u0026label=build\u0026logo=github\u0026style=flat-square\" alt=\"Build\"\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/mrz1836/mage-x/commits/master\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/mrz1836/mage-x?style=flat-square\u0026logo=git\u0026logoColor=white\u0026label=last%20update\" alt=\"Last Commit\"\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"right\"\u003e\n \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp; \u003ccode\u003eQuality\u003c/code\u003e \u0026nbsp;\u0026nbsp;\n \u003c/td\u003e\n \u003ctd align=\"left\"\u003e\n \u003ca href=\"https://goreportcard.com/report/github.com/mrz1836/mage-x\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/mrz1836/mage-x?style=flat-square\" alt=\"Go Report\"\u003e\u003c/a\u003e\n \u003ca href=\"https://app.codecov.io/gh/mrz1836/mage-x/tree/master\"\u003e\u003cimg src=\"https://codecov.io/gh/mrz1836/mage-x/branch/master/graph/badge.svg?style=flat-square\" alt=\"Coverage\"\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003c/tr\u003e\n\n \u003ctr\u003e\n \u003ctd align=\"right\"\u003e\n \u003ccode\u003eSecurity\u003c/code\u003e \u0026nbsp;\u0026nbsp;\n \u003c/td\u003e\n \u003ctd align=\"left\"\u003e\n \u003ca href=\"https://scorecard.dev/viewer/?uri=github.com/mrz1836/mage-x\"\u003e\u003cimg src=\"https://api.scorecard.dev/projects/github.com/mrz1836/mage-x/badge?style=flat-square\" alt=\"Scorecard\"\u003e\u003c/a\u003e\n \u003ca href=\".github/SECURITY.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/policy-active-success?style=flat-square\u0026logo=security\u0026logoColor=white\" alt=\"Security\"\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"right\"\u003e\n \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp; \u003ccode\u003eCommunity\u003c/code\u003e \u0026nbsp;\u0026nbsp;\n \u003c/td\u003e\n \u003ctd align=\"left\"\u003e\n \u003ca href=\"https://github.com/mrz1836/mage-x/graphs/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/mrz1836/mage-x?style=flat-square\u0026color=orange\" alt=\"Contributors\"\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/sponsors/mrz\"\u003e\u003cimg src=\"https://img.shields.io/badge/sponsor-mrz-181717.svg?logo=github\u0026style=flat-square\" alt=\"Sponsor\"\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n### \u003ccode\u003eProject Navigation\u003c/code\u003e\n\n\u003c/div\u003e\n\n\u003ctable align=\"center\"\u003e\n \u003ctr\u003e\n \u003ctd align=\"center\" width=\"25%\"\u003e\n ๐Ÿงฉ\u0026nbsp;\u003ca href=\"#-whats-inside\"\u003e\u003ccode\u003eWhat's\u0026nbsp;Inside\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"center\" width=\"25%\"\u003e\n โšก\u0026nbsp;\u003ca href=\"#-quick-start\"\u003e\u003ccode\u003eQuick\u0026nbsp;Start\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"center\" width=\"25%\"\u003e\n ๐Ÿš€\u0026nbsp;\u003ca href=\"#-features\"\u003e\u003ccode\u003eFeatures\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"center\" width=\"25%\"\u003e\n โš™๏ธ\u0026nbsp;\u003ca href=\"#-configuration\"\u003e\u003ccode\u003eConfiguration\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003c/tr\u003e\n \u003ctr\u003e\n \u003ctd align=\"center\"\u003e\n ๐Ÿ“š\u0026nbsp;\u003ca href=\"#-documentation\"\u003e\u003ccode\u003eDocumentation\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"center\"\u003e\n ๐Ÿ“\u0026nbsp;\u003ca href=\"#-spec-driven-development\"\u003e\u003ccode\u003eSDD\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"center\"\u003e\n ๐Ÿงช\u0026nbsp;\u003ca href=\"#-examples--tests\"\u003e\u003ccode\u003eExamples\u0026nbsp;\u0026\u0026nbsp;Tests\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"center\"\u003e\n โšก\u0026nbsp;\u003ca href=\"#-benchmarks\"\u003e\u003ccode\u003eBenchmarks\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003c/tr\u003e\n \u003ctr\u003e\n \u003ctd align=\"center\"\u003e\n ๐Ÿ› ๏ธ\u0026nbsp;\u003ca href=\"#-code-standards\"\u003e\u003ccode\u003eCode\u0026nbsp;Standards\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"center\"\u003e\n ๐Ÿค–\u0026nbsp;\u003ca href=\"#-ai-usage--assistant-guidelines\"\u003e\u003ccode\u003eAI\u0026nbsp;Usage\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"center\"\u003e\n ๐Ÿค\u0026nbsp;\u003ca href=\"#-contributing\"\u003e\u003ccode\u003eContributing\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003ctd align=\"center\"\u003e\n ๐Ÿ“\u0026nbsp;\u003ca href=\"#-license\"\u003e\u003ccode\u003eLicense\u003c/code\u003e\u003c/a\u003e\n \u003c/td\u003e\n \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003cbr/\u003e\n\n## ๐Ÿงฉ What's Inside\n\n**MAGE-X** revolutionizes Go build tooling with TRUE zero-boilerplate. Unlike traditional Mage which requires writing wrapper functions, MAGE-X provides all commands instantly through the `magex` binary.\n\n\u003cbr/\u003e\n\n- **Truly Zero-Configuration**\u003cbr/\u003e\n _No magefile.go needed. No imports. No wrappers. Just install `magex` and all built-in and custom commands work immediately in any Go project._\n \u003cbr/\u003e\u003cbr/\u003e\n- **Drop-in Mage Replacement**\u003cbr/\u003e\n _`magex` is a superset of `mage` with all MAGE-X commands built-in. Your existing magefiles still work, now enhanced with 190+ professional commands._\n \u003cbr/\u003e\u003cbr/\u003e\n- **Cross-Platform Excellence**\u003cbr/\u003e\n _Full support for Linux, macOS, and Windows with multi-architecture builds, parallel execution, and CPU-aware optimization._\n \u003cbr/\u003e\u003cbr/\u003e\n- **Security-First Architecture**\u003cbr/\u003e\n _Input validation, secure command execution, and minimal dependencies. Built for environments where security matters._\n \u003cbr/\u003e\u003cbr/\u003e\n- **Professional Release Tooling**\u003cbr/\u003e\n _Standardized versioning commands, GitHub integration, GoDocs proxy sync, and release tooling for production deployments._\n \u003cbr/\u003e\u003cbr/\u003e\n- **Smart Documentation System**\u003cbr/\u003e\n _Hybrid pkgsite/godoc support with auto-detection, port management, and cross-platform browser integration._\n \u003cbr/\u003e\u003cbr/\u003e\n\n### ๐ŸŽฅ Demo\n\n\u003cimg src=\"examples/demo.gif\" alt=\"MAGE-X Demo\" title=\"MAGE-X Demo\"/\u003e\n\n\u003cbr\u003e\n\n## โšก Quick Start\n\n### Which Path Should I Take?\n\nMAGE-X automatically detects your project structure and **just works**:\n\n| Your Project Structure | What MAGE-X Does |\n|-------------------------------------|-----------------------------------|\n| **Single Binary** `main.go` in root | Builds to `bin/projectname` |\n| **Multi-Binary** `cmd/*/main.go` | Auto-detects \u0026 builds first found |\n| **Library** No main package | Verifies compilation with `./...` |\n\n\u003e ๐Ÿ“– See the [Complete Quick Start Guide](docs/QUICK_START.md) for project-specific examples and troubleshooting.\n\n\u003cbr\u003e\n\n### Zero Boilerplate Installation\n\n```bash\n# Install magex (production branch)\ngo install github.com/mrz1836/mage-x/cmd/magex@latest\n\n# Auto-update to latest stable release (with proper version info)\nmagex update:install\n\n# MAGE-X automatically checks for updates in the background\n# and notifies you when new versions are available\n\n# Now use it in ANY Go project (no setup!)\n# Use either 'magex' or its shorter alias 'mgx'\nmagex build # Automatically detects \u0026 builds your project\nmagex test # Run your tests\nmagex bench # Run your benchmarks\nmagex lint:fix # Fix any linting issues\nmagex format:fix # Format your code\n\n# That's it! No magefile.go needed! ๐Ÿš€\n```\n\n\u003cbr\u003e\n\n### Quick Project Check\n```bash\n# See what MAGE-X detects in your project:\nmagex build --dry-run # Shows what will be built without building\n\n# or use the shorter alias:\nmgx build --dry-run # Same command, shorter to type\n```\n\n\u003cbr\u003e\n\n### Full Command List\n\n```bash\nmagex help # List all commands \u0026 get help\nmagex -n # Commands by namespace\nmagex -search test # Find specific commands\n# Remember: you can use 'magex' or 'mgx' interchangeably\n```\n\n\u003cbr\u003e\n\n### _Optional:_ Add Custom Commands\n\nOnly create a `magefile.go` if you need project-specific commands:\n\n```go\n//go:build mage\npackage main\n\n// Your custom command (works alongside all MAGE-X commands!)\nfunc Deploy() error {\n // Custom deployment logic\n return nil\n}\n```\n\nNow you have both:\n```bash\nmagex build # Built-in MAGE-X command\nmagex deploy # Your custom command\n```\n\n### Hybrid Execution Model\n\nMAGE-X uses a smart hybrid approach that provides the best of both worlds:\n\n- **Built-in commands** execute directly for speed and consistency (`magex build`, `magex test`, etc.)\n- **Custom commands** in your magefile.go are automatically discovered and delegated to `mage`\n- **Unified interface** - one standardized CLI for all tools\n\nThis means:\n- `magex build` (or `mgx build`) always behaves consistently across all projects\n- Your custom commands work seamlessly without any setup\n- No plugin compilation or platform-specific issues\n- Zero configuration required\n\n\u003cbr\u003e\n\n## ๐Ÿš€ Features\n\n### Core Excellence\n- **Command Execution**: Secure, interface-based command execution with validation\n- **Native Logging**: Colored output, progress indicators, and structured logging\n- **Complete Build Toolchain**: All essential build, test, lint, and release tasks\n- **Version Management**: Automatic version detection and update infrastructure with sub-module support for multi-module repositories\n\n### Developer Experience\n- **Release Tooling**: Multi-platform asset building with GitHub integration\n- **Configuration Management**: Flexible mage.yaml with smart defaults\n- **Command Discovery**: Comprehensive CLI with intuitive command structure\n- **Help System**: Built-in documentation and usage examples\n\n### Production Features\n- **Security Scanning**: Vulnerability detection with govulncheck integration\n- **Configuration Management**: Centralized project configuration and validation\n- **Extensible Architecture**: Plugin-ready foundation for custom production needs\n\n\u003cbr/\u003e\n\n## โš™๏ธ Configuration\n\nMAGE-X works without any configuration, but you can customize behavior with `.mage.yaml` or environment variables.\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ“‹ \u003cstrong\u003eConfiguration File (.mage.yaml)\u003c/strong\u003e\u003c/summary\u003e\n\nCreate `.mage.yaml` in your project root for custom settings:\n\n```yaml\nproject:\n name: my-project\n binary: myapp\n version: v1.0.0\n module: github.com/user/my-project\n\nbuild:\n output: bin\n trimpath: true\n platforms:\n - linux/amd64\n - darwin/amd64\n - darwin/arm64\n - windows/amd64\n tags:\n - prod\n ldflags:\n - -s -w\n - -X main.version={{.Version}}\n - -X main.commit={{.Commit}}\n\ntest:\n parallel: true\n timeout: 10m\n race: false\n cover: true\n covermode: atomic\n\nlint:\n golangci_version: v2.3.1\n timeout: 5m\n\ntools:\n golangci_lint: v2.3.1\n fumpt: latest\n govulncheck: latest\n\nrelease:\n github:\n owner: mrz\n repo: my-project\n platforms:\n - linux/amd64\n - darwin/amd64\n - darwin/arm64\n - windows/amd64\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐ŸŒ \u003cstrong\u003eEnvironment Variable Overrides\u003c/strong\u003e\u003c/summary\u003e\n\nOverride any configuration with environment variables:\n\n```bash\n# Build configuration\nexport MAGE_X_BINARY_NAME=myapp\nexport MAGE_X_BUILD_TAGS=prod,feature1\nexport GOOS=linux\nexport GOARCH=amd64\n\n# Test configuration\nexport MAGE_X_VERBOSE=true\nexport MAGE_X_TEST_RACE=true\nexport MAGE_X_TEST_TIMEOUT=15m\n\n# Linting configuration\nexport MAGE_X_LINT_VERBOSE=true # Enable verbose linting output\nexport MAGE_X_LINT_TIMEOUT=10m\n\n# Tool configuration\nexport MAGE_X_PARALLEL=8\n\n# Benchmark timing with parameters\nmagex bench time=50ms # Quick benchmarks\nmagex bench time=10s # Full benchmarks\nmagex bench:cpu time=30s # CPU profiling\nmagex bench:save time=5s output=results.txt\nmagex bench time=2s count=5 # With custom count parameter\n\n# Version management examples with new parameter format\nmagex version:bump bump=patch # Bump patch version\nmagex version:bump bump=minor push # Bump minor and push\nmagex version:bump bump=patch branch=master push # Switch to master, bump, and push\nmagex git:tag version=1.2.3 # Create git tag\nmagex git:commit message=\"fix: bug fix\" # Commit with message\n```\n\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n## ๐Ÿ“š Documentation\n\nFor comprehensive documentation, visit the [docs](docs) directory:\n\n- **[Getting Started](docs/README.md)** - Complete documentation index\n- **[Namespace Interface Architecture](docs/NAMESPACE_INTERFACES.md)** - Modern interface-based namespace system\n- **[API Reference](docs/API_REFERENCE.md)** - Complete interface and API documentation\n- **[Quick Start](docs/QUICK_START.md)** - Get up and running in minutes\n- **[Configuration Reference](docs/CONFIGURATION.md)** - Complete configuration guide\n\n\u003cbr\u003e\n\n### Available Commands\n\nMAGE-X provides 190+ commands organized by functionality. All commands work instantly through the `magex` CLI.\n\n\u003cdetails\u003e\n\u003csummary\u003e๐ŸŽฏ \u003cstrong\u003eEssential Commands\u003c/strong\u003e\u003c/summary\u003e\n\n**Quick Discovery:**\n```bash\nmagex help:default # Beautiful command listing with categories and emojis\nmagex -l # Plain list of all available targets\nmagex -search test # Find specific commands\n```\n\n**Most Used Commands:**\n```bash\nmagex # Run default build\nmagex build # Build for current platform\nmagex test # Run complete test suite\nmagex bench # Run benchmarks\nmagex lint:fix # Auto-fix linting issues\nmagex format:fix\t\t # Format code automatically\nmagex version:bump \t # Bump version (patch, minor, major)\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ—๏ธ \u003cstrong\u003eCode Generation\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nmagex generate:default # Run go generate\nmagex generate:clean # Remove generated files\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ“ฆ \u003cstrong\u003eDependencies \u0026 Modules\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Dependency Management\nmagex deps:update # Update dependencies (safe - no major version bumps)\nmagex deps:update allow-major # Update including major versions (v1โ†’v2, etc)\nmagex deps:tidy # Clean up go.mod and go.sum\nmagex deps:download # Download all dependencies\nmagex deps:outdated # Show outdated dependencies\nmagex deps:audit # Audit dependencies for vulnerabilities\nmagex deps:audit exclude=CVE-2024-38513,CVE-2023-45142 # Exclude specific CVEs from audit\n\n# Multi-Module Update (for monorepos with multiple go.mod files)\nmagex deps:update all-modules # Update all modules in workspace\nmagex deps:update all-modules dry-run # Preview modules without updating\nmagex deps:update all-modules fail-fast # Stop on first module error\nmagex deps:update all-modules verbose # Show detailed update info\nmagex deps:update all-modules allow-major stable-only verbose fail-fast # All options\n\n# Module Management\nmagex mod:update # Update go.mod file\nmagex mod:tidy # Tidy the go.mod file\nmagex mod:verify # Verify module checksums\nmagex mod:download # Download modules\nmagex mod:graph # Visualize dependency graph as tree with relationships\nmagex mod:why # Show why specific modules are needed\n\n# Dependency Graph Examples\nmagex mod:graph # Default tree view with versions\nmagex mod:graph depth=3 # Limit depth to 3 levels\nmagex mod:graph show_versions=false # Hide version numbers\nmagex mod:graph format=json # JSON output format\nmagex mod:graph format=dot # DOT format for graphviz\nmagex mod:graph format=mermaid # Mermaid diagram format\nmagex mod:graph filter=github.com depth=2 # Filter + depth combined\nmagex mod:graph show_versions=false format=tree # Clean tree view\n\n# Module Dependency Analysis Examples\nmagex mod:why github.com/stretchr/testify # Show why testify is needed\nmagex mod:why github.com/pkg/errors golang.org/x/sync # Analyze multiple modules\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ“ฆ \u003cstrong\u003eBuild \u0026 Compilation\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nmagex build:default # Build for current platform\nmagex build:all # Build for all configured platforms\nmagex build:clean # Clean build artifacts\nmagex build:generate # Generate code before building\nmagex build:linux # Build for Linux amd64\nmagex build:darwin # Build for macOS (amd64 and arm64)\nmagex build:windows # Build for Windows amd64\nmagex build:install # Install binary to $GOPATH/bin\nmagex build:dev # Build and install development version (forced 'dev' version)\nmagex build:prebuild # Pre-build all packages to warm cache\nmagex build:prebuild parallel=2 # Pre-build with 2 parallel processes\nmagex build:prebuild p=4 # Pre-build with 4 parallel processes (short form)\n\n# Memory-efficient prebuild strategies (great for CI/CD environments)\nmagex build:prebuild strategy=incremental batch=10 # Build in batches of 10 packages\nmagex build:prebuild strategy=mains-first # Build main packages first, then dependencies\nmagex build:prebuild strategy=smart # Auto-select best strategy based on available memory\nmagex build:prebuild strategy=full p=8 # Traditional full build with 8 parallel jobs\n\n# Advanced prebuild options\nmagex build:prebuild strategy=incremental batch=5 delay=100 # 100ms delay between batches\nmagex build:prebuild strategy=mains-first mains-only=true # Only build main packages\nmagex build:prebuild exclude=test verbose=true # Exclude test packages, verbose output\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿงช \u003cstrong\u003eTesting \u0026 Quality\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nmagex test # Run complete test suite with linting\nmagex test:unit # Run unit tests only\nmagex test:short # Run short tests (excludes integration tests)\nmagex test:race # Run tests with race detector\nmagex test:cover # Run tests with coverage analysis\nmagex test:coverrace # Run tests with both coverage and race detector\nmagex test:bench # Run benchmark tests\nmagex bench # Run benchmarks with default timing\nmagex bench time=50ms # Run quick benchmarks (50ms duration)\nmagex bench time=10s count=3 # Run benchmarks with custom time and count\nmagex test:fuzz # Run fuzz tests (default: 10s)\nmagex test:fuzz time=30s # Run fuzz tests with custom duration\nmagex test:fuzzShort time=1s # Run short fuzz tests with custom duration\nmagex test:integration # Run integration tests\n\n# JSON Output Support for Test Commands\nmagex test -json # Run tests with JSON output for tooling\nmagex test:unit -json # Unit tests with JSON output\nmagex test:race -json # Race detection with JSON output\nmagex test:cover -json # Coverage tests with JSON output\nmagex test:coverrace -json # Coverage + race with JSON output\nmagex test:short -json # Short tests with JSON output\n\n# Advanced Test Options (all commands support these flags)\nmagex test -v # Verbose output\nmagex test:cover -count=3 # Run tests 3 times\nmagex test -failfast # Stop at first failure\nmagex test -shuffle=on # Randomize test execution\nmagex test -parallel=4 # Set parallel test execution\n\n# Code Quality \u0026 Linting\nmagex format:fix # Run code formatting\nmagex lint # Run essential linters\nmagex lint verbose=true # Run linters with verbose output\nmagex lint:fix # Auto-fix linting issues + apply formatting\nmagex lint:issues # Scan for TODOs, FIXMEs, nolint directives, and test skips\nmagex lint:verbose # Alternative: dedicated verbose linting command\nmagex lint:version \t\t # Show golangci-lint version\nmagex test:vet # Run go vet static analysis\nmagex tools:verify # Show tool version information\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿค– \u003cstrong\u003eCI Test Output Mode\u003c/strong\u003e\u003c/summary\u003e\n\nMAGE-X automatically detects CI environments and produces structured test output with precise file:line locations for failures. This eliminates complex bash/jq parsing in CI workflows.\n\n**Automatic Detection** (Zero Configuration):\n```bash\n# In GitHub Actions (or any CI with CI=true) - works automatically!\nmagex test:unit # Produces GitHub annotations + JSONL output\n\n# Locally - unchanged behavior\nmagex test:unit # Standard terminal output\n```\n\n**Explicit CI Mode**:\n```bash\nmagex test:unit ci # Force CI mode locally (preview CI output)\nmagex test:unit ci=false # Disable CI mode in CI environment\n```\n\n**All test commands support CI mode**:\n- `magex test:unit ci`\n- `magex test:race ci`\n- `magex test:cover ci`\n- `magex test:fuzz ci`\n\n**Output in CI**:\n- **GitHub Annotations**: Clickable file:line links in PR sidebar\n- **Step Summary**: Markdown table in `$GITHUB_STEP_SUMMARY`\n- **Structured Output**: `.mage-x/ci-results.jsonl` for automation\n\n**Configuration** (optional in `.mage.yaml`):\n```yaml\ntest:\n ci_mode:\n enabled: auto # auto (default), on, or off\n format: github # auto, github, or json\n context_lines: 20 # Lines of code context around failures\n output_path: \".mage-x/ci-results.jsonl\"\n```\n\n**Environment Variables**:\n```bash\nexport MAGE_X_CI_MODE=auto # auto/on/off\nexport MAGE_X_CI_FORMAT=github # github/json/auto\nexport MAGE_X_CI_CONTEXT=20 # Context lines (0-100)\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eโœ… \u003cstrong\u003eCode Validation \u0026 Formatting\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Code Validation\nmagex vet:default # Run go vet\nmagex vet:all # Run go vet with all checks\nmagex vet:parallel # Run go vet in parallel\nmagex vet:shadow # Check for variable shadowing\nmagex vet:strict # Run strict vet checks\n\n# Code Formatting\nmagex format:default # Default formatting (gofmt)\nmagex format:all # Format all supported file types\nmagex format:gofmt # Run gofmt\nmagex format:fumpt # Run gofumpt (stricter formatting)\nmagex format:imports # Format imports\nmagex format:go # Format Go files\nmagex format:yaml # Format YAML files\nmagex format:json # Format JSON files\nmagex format:fix # Fix formatting issues automatically\nmagex format:check # Check if files are properly formatted\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ“Š \u003cstrong\u003eAnalysis \u0026 Metrics\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Lines of Code Analysis (Multi-language support)\nmagex metrics:loc # Analyze Go lines of code (default)\nmagex metrics:loc lang=go # Explicitly analyze Go files\nmagex metrics:loc lang=js # Analyze JavaScript/TypeScript files (.js, .ts, .jsx, .tsx)\nmagex metrics:loc lang=yaml # Analyze YAML files (.yaml, .yml)\nmagex metrics:loc lang=js json # JS metrics with JSON output\n\n# Other Metrics\nmagex metrics:mage # Analyze magefiles and targets\nmagex metrics:coverage # Generate coverage reports\nmagex metrics:complexity # Analyze code complexity\n\n# Performance \u0026 Benchmarking\nmagex bench # Default benchmark operations\nmagex bench time=50ms # Quick benchmarks (50ms runs)\nmagex bench time=10s # Comprehensive benchmarks (10s runs)\nmagex bench count=3 # Run benchmarks 3 times\nmagex bench:profile # Profile application performance\nmagex bench:compare # Compare benchmark results\nmagex bench:regression # Check for performance regressions\nmagex bench:cpu time=30s # CPU usage benchmarks with custom duration\nmagex bench:mem time=2s # Memory usage benchmarks\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ“š \u003cstrong\u003eDocumentation\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nmagex docs # Generate and serve documentation (generate + serve in one command)\nmagex docs:generate # Generate Go package documentation from source code\nmagex docs:serve # Serve documentation locally with hybrid pkgsite/godoc support\nmagex docs:build # Build enhanced static documentation files with metadata\nmagex docs:check # Validate documentation completeness and quality\nmagex docs:update # Update GoDocs proxy (trigger pkg.go.dev sync)\nmagex docs:godocs # Update GoDocs proxy (alias for docs:update)\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ”€ \u003cstrong\u003eGit \u0026 Version Control\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Git Operations\nmagex git:status # Show git repository status\nmagex git:commit message=\"fix: commit message\" # Commit changes with message parameter\nmagex git:tag version=1.2.3 # Create and push a new tag with version parameter\nmagex git:tagremove version=1.2.3 # Remove a tag\nmagex git:tagupdate version=1.2.3 # Force update a tag\n\n# Version Management\nmagex version:show # Display current version information\nmagex version:modules # List all discovered sub-modules (for multi-module repos)\nmagex version:check # Check version information and compare with latest\nmagex version:update # Update to latest version\nmagex version:bump # Bump version (patch, minor, major)\nmagex version:changelog # Generate changelog from git history\nmagex version:tag # Create version tag\nmagex version:compare # Compare two versions\nmagex version:validate # Validate version format\n\n# Version Bump Examples (now using parameters)\nmagex version:bump # Bump patch version (default)\nmagex version:bump bump=minor # Bump minor version\nmagex version:bump bump=major major-confirm # Bump major version with confirmation\nmagex version:bump bump=minor push # Bump minor and push to remote\n\n# Branch Parameter Examples (recommended for virtual branch workflows)\nmagex version:bump bump=patch branch=master push # Switch to master, bump patch, and push\nmagex version:bump bump=minor branch=main # Switch to main branch before bumping\nmagex version:bump bump=major branch=master major-confirm push # Major bump on master with push\n\n# Dry-run mode (preview changes without making them)\nmagex version:bump dry-run # Preview patch bump\nmagex version:bump bump=minor dry-run # Preview minor bump\nmagex version:bump bump=major major-confirm push dry-run # Preview major bump with push\nmagex version:bump bump=patch branch=master dry-run # Preview branch switch and bump\n\n# Sub-module Versioning (for multi-module repositories like spv-wallet)\nmagex version:modules # List all discovered sub-modules\nmagex version:bump module=models bump=patch # Bump specific sub-module\nmagex version:bump module=all bump=minor # Bump all sub-modules together\nmagex version:bump module=* bump=patch push # Bump root + all sub-modules\nmagex version:bump module=models dry-run # Preview sub-module bump\n\n# Important Notes:\n# - Uncommitted changes will block version bump operation (safety check)\n# - When using branch parameter, you will ALWAYS return to your original branch after completion\n# - Branch switch-back happens even if tag creation or push fails (guaranteed cleanup)\n# - If network issues occur during pull, operation stops but still switches back to original branch\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿš€ \u003cstrong\u003eRelease Management\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Core Release Operations\nmagex release # Create a new release from the latest tag\nmagex release godocs # Create a release and update GoDocs proxy\nmagex release:default # Create a new release from the latest tag\nmagex release:test # Dry-run release without publishing\nmagex release:snapshot # Build release artifacts without git tag\nmagex release:localinstall # Build from latest tag and install locally\n\n# Release Setup \u0026 Validation\nmagex release:init # Initialize .goreleaser.yml configuration\nmagex release:check # Validate .goreleaser.yml configuration\nmagex release:validate # Comprehensive release readiness validation\nmagex release:changelog # Generate changelog from git history\nmagex release:clean # Clean release artifacts and build cache\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eโ˜๏ธ \u003cstrong\u003eAWS Credential Management\u003c/strong\u003e\u003c/summary\u003e\n\nManage AWS credentials with MFA authentication. Requires AWS CLI to be installed.\n\n```bash\n# Smart login - detects if setup is needed, then performs MFA refresh\nmagex aws:login # Login with default profile\nmagex aws:login profile=production # Login with specific profile\n\n# Interactive setup - configure credentials and MFA device\nmagex aws:setup # Setup default profile\nmagex aws:setup profile=staging # Setup specific profile\n\n# MFA refresh - get temporary session credentials\nmagex aws:refresh # Refresh default profile\nmagex aws:refresh profile=prod # Refresh specific profile\nmagex aws:refresh duration=28800 # Custom session duration (8 hours)\n\n# Status - view credential status\nmagex aws:status # Show all profiles\nmagex aws:status profile=dev # Show specific profile\n```\n\n**Prerequisites:**\n- AWS CLI must be installed and accessible in your PATH\n - **macOS:** `brew install awscli`\n - **Linux (Ubuntu/Debian):** `sudo apt-get install awscli`\n - **Linux (RHEL/CentOS):** `sudo yum install aws-cli`\n - **Windows:** [Download MSI installer](https://awscli.amazonaws.com/AWSCLIV2.msi)\n - **Official guide:** [AWS CLI Installation](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)\n- IAM user with MFA device configured\n\n**Workflow:**\n1. Run `magex aws:setup` to configure your Access Key, Secret Key, and MFA device ARN\n2. Run `magex aws:login` daily to refresh your session credentials with MFA\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ”ง \u003cstrong\u003eDevelopment Tools\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nmagex tools:update # Update all development tools\nmagex tools:install # Install all required development tools\nmagex tools:verify # Check if all required tools are available\nmagex deps:audit # Run vulnerability check using govulncheck\nmagex build:install # Install the project binary\nmagex build:dev # Build and install development version (forced 'dev' version)\nmagex install:stdlib # Install Go standard library for cross-compilation\nmagex uninstall # Remove installed binary\n\n# Spec-Kit CLI Management\nmagex speckit:install # Install spec-kit prerequisites (uv, uvx, specify-cli)\nmagex speckit:check # Verify spec-kit installation and report version info\nmagex speckit:upgrade # Upgrade spec-kit with automatic constitution backup/restore\n\n# BMAD CLI Management\nmagex bmad:install # Install BMAD prerequisites (npm, npx, bmad-method)\nmagex bmad:check # Verify BMAD installation and report version info\nmagex bmad:upgrade # Upgrade BMAD to the latest beta version\n\n# Agent OS CLI Management\nmagex agentos:install # Install Agent OS (base + project)\nmagex agentos:check # Verify Agent OS installation and report version info\nmagex agentos:upgrade # Upgrade Agent OS with user data preservation\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ’ป \u003cstrong\u003eTmux Session Management\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Claude Code Pairing Sessions\nmagex tmux:start # Start Claude Code in current directory\nmagex tmux:start dir=~/projects/foo # Start in specific directory\nmagex tmux:start model=opus # Start with specific model (opus/sonnet/haiku)\nmagex tmux:start dir=~/projects/foo name=my-session model=opus # All options\n\n# Session Management\nmagex tmux:list # List all active tmux sessions\nmagex tmux:attach name=my-session # Attach to existing session\nmagex tmux:kill name=my-session # Kill specific session\nmagex tmux:killall # Kill all sessions (with confirmation)\nmagex tmux:status # Show session health and status\n\n# Supported Models\n# - opus: claude-opus-4-5\n# - sonnet: claude-sonnet-4-5 (default)\n# - haiku: claude-haiku-4-5\n# - gpt: gpt-4o\n# - o1: o1\n# - o3: o3-mini\n# - gemini: gemini-3-flash\n\n# Session auto-attach: If a session already exists, tmux:start will attach to it\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eโš™๏ธ \u003cstrong\u003eConfiguration Management\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\nmagex configure:init # Initialize a new mage configuration\nmagex configure:show # Display the current configuration\nmagex configure:update # Update configuration values interactively\nmagex configure:export # Export configuration to file\nmagex configure:import # Import configuration from file\nmagex configure:validate # Validate configuration integrity\nmagex configure:schema # Show configuration schema\n\n# YAML Configuration\nmagex yaml:init # Create mage.yaml configuration\nmagex yaml:validate # Validate YAML configuration\nmagex yaml:show # Show current YAML configuration\nmagex yaml:template # Generate YAML templates\nmagex yaml:format # Format YAML files\nmagex yaml:check # Check YAML syntax\nmagex yaml:merge # Merge YAML configurations\nmagex yaml:convert # Convert between YAML formats\nmagex yaml:schema # Show YAML schema\n```\n\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ“– \u003cstrong\u003eHelp \u0026 Updates\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Help System\nmagex help:default # Show general help\nmagex help:commands # List all available commands\nmagex help:examples # Show usage examples\nmagex help:gettingstarted # Getting started guide\nmagex help:completions # Generate shell completions\n\n# Update Management\nmagex update:check # Check for updates\nmagex update:install # Install the latest update\n\n# Installation Management\nmagex install:default # Default installation\nmagex install:local # Install locally\nmagex install:binary # Install project binary\nmagex install:tools # Install development tools\nmagex install:go # Install Go\nmagex install:stdlib # Install Go standard library\nmagex install:systemwide # Install system-wide\nmagex install:deps # Install dependencies\nmagex install:mage # Install mage\nmagex install:githooks # Install git hooks\nmagex install:ci # Install CI components\nmagex install:certs # Install certificates\nmagex install:package # Install package\nmagex install:all # Install everything\nmagex uninstall # Remove installation\n```\n\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n### ๐Ÿ“‹ Complete Command List\n\nRun `magex -l` to see a plain list of all available commands (190+ commands), or use `magex help` for a beautiful categorized view with descriptions and usage tips.\n\n\u003cbr/\u003e\n\n### ๐Ÿ“š Documentation System\n\nMAGE-X includes a hybrid documentation system with auto-detection and cross-platform browser integration.\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ“– \u003cstrong\u003eDocumentation Features \u0026 Capabilities\u003c/strong\u003e\u003c/summary\u003e\n\n#### Smart Tool Detection\n- **Auto-detection**: Automatically detects and uses the best available documentation tool\n- **Hybrid Support**: Supports both `pkgsite` (modern) and `godoc` (classic) with smart fallback\n- **Auto-installation**: Automatically installs missing tools when needed\n- **Configuration Control**: Override tool selection with `docs.tool` in .mage.yaml\n\n#### Multiple Serving Modes\n```bash\n# Documentation serving\nmagex docs:serve # Serve documentation locally\nmagex docs:godocs # Serve with godoc format\nmagex docs:api # API documentation\nmagex docs:examples # Example documentation\nmagex docs:readme # README documentation\n```\n\n#### Advanced Features\n- **Port Management**: Automatic port detection and conflict resolution\n- **Cross-Platform**: Browser auto-opening on macOS, Linux, and Windows\n- **CI/CD Ready**: Detects CI environments and disables browser opening\n- **Comprehensive Generation**: Documents all packages with categorization\n- **Static Building**: Enhanced Markdown with metadata and navigation\n- **Build Artifacts**: JSON metadata and organized output structure\n\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n### ๐Ÿ”ง Advanced Namespaces\n\nMAGE-X includes specialized namespaces for power users. These are opt-in to keep the core installation lightweight.\n\n\u003cdetails\u003e\n\u003csummary\u003e๐Ÿ”ง \u003cstrong\u003eAdvanced Namespace Configuration\u003c/strong\u003e\u003c/summary\u003e\n\n**Available Specialized Namespaces:**\n- **Bench** - Performance benchmarking and profiling\n- **Releases** - Release creation and asset distribution\n- **Yaml** - YAML configuration management and validation\n\n**To enable advanced features in your magefile:**\n```go\n//go:build mage\n\npackage main\n\nimport \"github.com/mrz1836/mage-x/pkg/mage\"\n\n// Export core namespaces (already included by default)\ntype (\n Build = mage.Build\n Test = mage.Test\n // ... other default namespaces\n)\n\n// Add advanced namespaces as needed\ntype (\n Integrations = mage.Integrations\n Bench = mage.Bench\n Releases = mage.Releases\n)\n```\n\nThis approach keeps the default installation lightweight while allowing power users to access advanced features when needed.\n\n**Example: Production Operations**\n```go\n// Run benchmarking and performance analysis\nfunc PerformanceTest() error {\n var bench Bench\n return bench.Default()\n}\n\n// Run quick benchmarks with custom timing\nfunc QuickBench() error {\n var bench Bench\n return bench.DefaultWithArgs(\"time=50ms\")\n}\n```\n\n\u003c/details\u003e\n\nSee the [examples directory](examples) for more custom magefile implementations.\n\n\u003cbr/\u003e\n\n## ๐Ÿ“ Spec-Driven Development\n\nIntegrated support for AI-driven development methodologies. **Choose your style:**\n\n| | ๐Ÿ“‹ **Spec-Kit** (Recommended) | ๐Ÿš€ **BMAD** | ๐Ÿค– **Agent OS** |\n|---|---|---|---|\n| **Philosophy** | Executable specifications | Agile workflows with AI agents | Structured agentic workflows |\n| **Interface** | CLI slash commands (`/commands`) | IDE-based agents (`*commands`) | Claude Code commands + agents |\n| **Workflow** | Specify โ†’ Plan โ†’ Tasks โ†’ Implement | PRD โ†’ Tech Spec โ†’ Architecture โ†’ Sprint | Write Spec โ†’ Shape โ†’ Plan โ†’ Tasks โ†’ Implement |\n| **Package** | Python (`specify-cli`) | npm (`bmad-method`) | Shell scripts (curl install) |\n| **Complexity** | Simple, streamlined | Full agile methodology | Flexible, profile-based |\n| **Best for** | Quick start, precise requirements | Large projects, team workflows | Claude Code users, multi-agent workflows |\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e๐Ÿ“‹ Spec-Kit - Executable Specifications (Recommended)\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\n[Spec-Kit](https://github.com/github/spec-kit) transforms specifications into working implementations. Simple, streamlined, and perfect for getting started quickly. All feature specs live in [`specs/`](specs).\n\n### Quick Start\n\n```bash\n# Install spec-kit prerequisites\nmagex speckit:install\n```\n\n### Development Workflow\n\nFollow the spec-kit workflow to create and implement new features:\n\n#### 1. **Constitution** (One-time setup)\nEstablish project principles and development guidelines.\n```bash\n/speckit.constitution\n```\n\n#### 2. **Specify** (Define requirements)\nDescribe *what* and *why*, not the technology. Focus on requirements and user stories.\n```bash\n/speckit.specify\n```\n\n#### 3. **Clarify** (Optional but recommended)\nAddress underspecified areas with targeted questions.\n```bash\n/speckit.clarify\n```\n\n#### 4. **Plan** (Design implementation)\nCreate technical implementation strategy with your chosen tech stack.\n```bash\n/speckit.plan\n```\n\n#### 5. **Tasks** (Generate action items)\nGenerate actionable, dependency-ordered task lists.\n```bash\n/speckit.tasks\n```\n\n#### 6. **Analyze** (Validate consistency)\nValidate cross-artifact consistency before implementation.\n```bash\n/speckit.analyze\n```\n\n#### 7. **Implement** (Build the feature)\nExecute all tasks to build the feature according to the plan.\n```bash\n/speckit.implement\n```\n\n### Management Commands\n\n```bash\nmagex speckit:install # Install spec-kit prerequisites\nmagex speckit:check # Check installation and version\nmagex speckit:upgrade # Upgrade with automatic backup/restore\n```\n\n**Configuration** (`.mage.yaml`):\n```yaml\nspeckit:\n constitution_path: \".specify/memory/constitution.md\"\n backup_dir: \".specify/backups\"\n backups_to_keep: 5\n ai_provider: \"claude\"\n```\n\n\u003e **Pro tip:** Run `/speckit.checklist` anytime to generate custom validation criteria.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eโฌ†๏ธ Upgrading Spec-Kit\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\n### Automated Upgrade (Recommended)\n\n```bash\nmagex speckit:upgrade\n```\n\nThe upgrade command automatically:\n- โœ… Backs up your constitution to `.specify/backups/` with timestamp\n- โœ… Upgrades the spec-kit CLI using `uv tool upgrade`\n- โœ… Updates project configuration with `--force` flag\n- โœ… Restores your constitution from backup\n- โœ… Tracks version history in `.specify/version.txt`\n- โœ… Cleans old backups (keeps last 5)\n- โœ… Verifies the upgrade with `specify check`\n\n### Manual Upgrade (Alternative)\n\nIf you prefer manual control:\n\n#### Step 1: Backup Your Constitution\n```bash\ncp .specify/memory/constitution.md ~/constitution.backup.md\n```\n\n#### Step 2: Upgrade the CLI\n```bash\nuv tool upgrade specify-cli\nspecify check\n```\n\n#### Step 3: Upgrade Project Configuration\n```bash\nuvx --from git+https://github.com/github/spec-kit.git specify init --here --ai claude --force\n```\n\n#### Step 4: Restore Custom Constitution\nIf you have custom constitution changes, carefully merge them back from your backup.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e๐Ÿš€ BMAD - AI-Driven Agile Development\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\n[BMAD](https://github.com/bmad-code-org/BMAD-METHOD) (Build More, Architect Dreams) provides a full agile methodology with AI agents. Best for larger projects or teams wanting structured agile workflows.\n\n### Quick Start\n\n```bash\n# Install BMAD with interactive setup\nmagex bmad:install\n```\n\n### Development Workflow\n\nAfter installation, work with BMAD agents in your IDE:\n\n#### 1. **Initialize** (Set up project)\nSelect your development track (greenfield, brownfield, or legacy).\n```\n*workflow-init\n```\n\n#### 2a. **Product Brief** (Product Requirements)\nCreate a comprehensive product brief with the PM agent.\n```\n*create-product-brief\n```\n\n#### 3a. **PRD** (Product Requirements)\nCreate a comprehensive Product Requirements Document with the PM agent.\n```\n*prd\n```\n\n#### 3b. **UX Design** (Optional)\nDesign user flows and wireframes with the UX agent.\n```\n*create-ux-design\n```\n\n#### 4. **Architecture** (System Design)\nDesign system architecture with the Architect agent.\n```\n*create-architecture\n```\n\n#### 5. **Create Epics \u0026 Stories** (Sprint Planning)\nBreak work into epics, sprints and prioritize stories.\n```\n*create-epics-and-stories\n```\n\n#### 6. **Test Design** (Test Engineering Architect)\nDesign test plans and cases with the TEA agent.\n```\n*testarch-test-design\n```\n\n#### 7. **Check Implementation Readiness** (Final validation)\nValidate all artifacts before development begins.\n```\n*check-implementation-readiness\n```\n\n#### 8. **Start Sprint Planning** (Development)\nDesign sprints and get started with development.\n```\n*sprint-planning\n```\n\nCheck the status of your sprints anytime:\n```\n*sprint-status\n```\n\n#### 9. **Create Story** (Individual tasks) (1 of 3)\nCreate individual user stories for implementation inside each sprint.\n```\n*create-story\n```\n\n#### 10. **Implement Stories** (Development) (2 of 3)\nImplement individual user story.\n```\n*dev-story\n```\n\n#### 11. **Code Review \u0026 Testing** (Quality Assurance) (3 of 3)\nReview and test completed user story.\n```\n*code-review\n```\n\n#### 12. **Retrospective** (Sprint Review)\nReflect on sprint performance and identify improvements.\n```\n*retrospective\n```\n\n### Management Commands\n\n```bash\nmagex bmad:install # Install BMAD prerequisites\nmagex bmad:check # Verify installation and version\nmagex bmad:upgrade # Upgrade to latest version\n```\n\n**Configuration** (`.mage.yaml`):\n```yaml\nbmad:\n project_dir: \"_bmad\"\n version_tag: \"@beta\"\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e๐Ÿค– Agent OS - Structured Agentic Workflows\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\n[Agent OS](https://github.com/buildermethods/agent-os) is a system for spec-driven agentic development that provides structured workflows for AI coding agents. It integrates deeply with Claude Code and supports multi-agent delegation.\n\n### Quick Start\n\n```bash\n# Install Agent OS (base + project)\nmagex agentos:install\n```\n\nThe installer will:\n1. Install the base Agent OS to `~/agent-os` (if not already installed)\n2. Run the interactive project installer to set up your project\n\n### Development Workflow\n\nAfter installation, use Claude Code slash commands to work through the Agent OS workflow:\n\n#### 1. **Write Spec** (Define your feature)\nCreate a detailed specification for your feature.\n```\n/write-spec\n```\n\n#### 2. **Shape Spec** (Refine requirements)\nShape and refine the specification with targeted questions.\n```\n/shape-spec\n```\n\n#### 3. **Plan Product** (Design implementation)\nCreate a technical implementation plan.\n```\n/plan-product\n```\n\n#### 4. **Create Tasks** (Generate action items)\nGenerate dependency-ordered tasks from the plan.\n```\n/create-tasks\n```\n\n#### 5. **Implement Tasks** (Build the feature)\nExecute tasks to implement the feature.\n```\n/implement-tasks\n```\n\n#### 6. **Orchestrate Tasks** (Multi-agent coordination)\nCoordinate multiple agents for complex implementations.\n```\n/orchestrate-tasks\n```\n\n### Management Commands\n\n```bash\nmagex agentos:install # Install Agent OS (base + project)\nmagex agentos:check # Verify installation and version\nmagex agentos:upgrade # Upgrade with user data preservation\n```\n\n**Configuration** (`.mage.yaml`):\n```yaml\nagentos:\n base_dir: \"agent-os\"\n profile: \"default\"\n claude_code_commands: true\n use_claude_code_subagents: true\n standards_as_skills: false\n```\n\n### User Data Preservation\n\nAgent OS preserves your important project data during upgrades:\n- `agent-os/specs/` - All your feature specifications\n- `agent-os/product/` - Your product roadmap and mission\n\nThe following are refreshed during upgrades:\n- `agent-os/standards/` - Standards from your profile\n- `.claude/commands/agent-os/` - Claude Code commands\n- `.claude/agents/agent-os/` - Claude Code agents\n\n\u003e **Pro tip:** Create custom profiles in `~/agent-os/profiles/` to customize standards and workflows without losing your changes during updates.\n\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n## ๐Ÿงช Examples \u0026 Tests\n\nAll examples and tests run via GitHub Actions using Go 1.24+. View the [examples directory](examples) for complete project demonstrations.\n\n### Run Tests\n\n```bash\n# Quick test suite\nmagex test\n\n# Comprehensive testing\nmagex test:race test:cover test:fuzz\n\n# JSON output for tooling integration\nmagex test -json # JSON output for CI/CD tools\nmagex test:coverrace -json # Coverage + race with JSON output\n\n# Performance benchmarks\nmagex bench # Default benchmarks (10s duration)\nmagex bench time=50ms # Quick benchmarks for CI\nmagex bench time=10s count=3 # Comprehensive benchmarks with count parameter\nmagex test:bench # Via test namespace\nmagex test:bench time=30s # Test namespace with custom timing\n```\n\n### Example Projects\n\n- **[Basic Project](examples/basic)** - Zero-configuration MAGE-X usage\n- **[With Configuration](examples/with-config)** - Using .mage.yaml for project customization\n- **[With Custom Commands](examples/with-custom)** - Adding project-specific commands\n- **[Zero Config](examples/zero-config)** - Instant productivity with magex\n\n\u003cbr/\u003e\n\n## โšก Benchmarks\n\nPerformance benchmarks for core MAGE-X operations:\n\n| Operation | Time | Memory | Notes |\n|-----------------------|-------|--------|-----------------------------------|\n| Build Detection | 1.2ms | 256KB | Project type and configuration |\n| Command Execution | 0.8ms | 128KB | Secure command validation |\n| Configuration Loading | 2.1ms | 512KB | YAML parsing and validation |\n\n\u003e Benchmarks run on Apple M1 Pro (ARM64) with Go 1.24+\n\u003e All operations show consistent sub-5ms performance with minimal memory allocation\n\n\u003cbr/\u003e\n\n## ๐Ÿ› ๏ธ Code Standards\n\nMAGE-X follows strict coding standards and best practices:\n\n- **Code Quality**: \u003e80% test coverage, comprehensive linting, and security scanning\n- **Go Best Practices**: Idiomatic Go code following community standards\n- **Security First**: Input validation, secure command execution, minimal dependencies\n- **Documentation**: Comprehensive godoc coverage and usage examples\n- **AI Compliance**: Machine-readable guidelines for AI assistants\n\nRead more about our [code standards](.github/CODE_STANDARDS.md) and [contribution guidelines](.github/CONTRIBUTING.md).\n\n\u003cbr/\u003e\n\n## ๐Ÿค– AI Usage \u0026 Assistant Guidelines\nRead the [AI Usage \u0026 Assistant Guidelines](.github/tech-conventions/ai-compliance.md) for details on how AI is used in this project and how to interact with the AI assistants.\n\n\u003cbr/\u003e\n\n## ๐Ÿ‘ฅ Maintainers\n\n| [\u003cimg src=\"https://github.com/mrz1836.png\" height=\"50\" width=\"50\" alt=\"Maintainer\" /\u003e](https://github.com/mrz1836) |\n|:------------------------------------------------------------------------------------------------------------------:|\n| [mrz](https://github.com/mrz1836) |\n\n\u003cbr/\u003e\n\n## ๐Ÿค Contributing\n\nWe welcome contributions from the community! Please read our [contributing guidelines](.github/CONTRIBUTING.md) and [code of conduct](.github/CODE_OF_CONDUCT.md).\n\n### How Can I Help?\n\nAll kinds of contributions are welcome! :raised_hands:\n\n- **โญ Star the project** to show your support\n- **๐Ÿ› Report bugs** through GitHub issues\n- **๐Ÿ’ก Suggest features** with detailed use cases\n- **๐Ÿ“ Improve documentation** with examples and clarity\n- **๐Ÿ”ง Submit pull requests** with bug fixes or new features\n\n\n[![Stars](https://img.shields.io/github/stars/mrz1836/mage-x?label=Please%20like%20us\u0026style=social)](https://github.com/mrz1836/mage-x/stargazers)\n\n\u003cbr/\u003e\n\n## ๐Ÿ“ License\n\n[![License](https://img.shields.io/github/license/mrz1836/mage-x.svg?style=flat\u0026v=1)](LICENSE)\n\n\u003cbr/\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n \u003cp\u003e\n \u003cstrong\u003eBuilt with โค๏ธ by the Go community\u003c/strong\u003e\n \u003c/p\u003e\n \u003cp\u003e\n \u003cem\u003eMAGE-X: Write Once, Mage Everywhere\u003c/em\u003e\n \u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrz1836%2Fmage-x","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrz1836%2Fmage-x","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrz1836%2Fmage-x/lists"}