README.md

June 14, 2026 · View on GitHub

Gomega: Ginkgo's Preferred Matcher Library

test

Jump straight to the docs to learn about Gomega, including a list of all available matchers.

If you have a question, comment, bug report, feature request, etc. please open a GitHub issue.

Using Gomega with Claude Code

Gomega ships a set of Claude Code skills as a plugin, so an agent writing assertions in your suite has Gomega's idioms — the full matcher catalog, Eventually/Consistently, and the gstruct/ghttp/gexec/gbytes/gleak/gmeasure sub-libraries — on hand. The Gomega repo doubles as the plugin marketplace, so installation is two commands. From inside Claude Code:

/plugin marketplace add onsi/gomega
/plugin install gomega@gomega

(or non-interactively: claude plugin marketplace add onsi/gomega then claude plugin install gomega@gomega)

This installs a family of gomega:* skills that activate automatically while you write tests. See the docs for the full list.

Ginkgo: a BDD Testing Framework for Golang

Learn more about Ginkgo here

Community Matchers

A collection of community matchers is available on the wiki.

License

Gomega is MIT-Licensed

The ConsistOf matcher uses goraph which is embedded in the source to simplify distribution. goraph has an MIT license.