# Installer goctl avec Homebrew, Nix

Consultez les chemins d'installation, exécutables, métadonnées et notes de sécurité de goctl pour les workflows d'agents IA.

## installation

```sh
sudo av install brew:goctl
```

Commandes d'installation supplémentaires:

### macOS

- Homebrew (100%):

```sh
brew install goctl
```

  Preuve: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#goctl
```

  Preuve: nixpkgs package indexes: pkgs/by-name/go/goctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Faits du paquet

- **Clé du paquet:** brew:goctl
- **Gestionnaire de paquets:** Homebrew
- **Page du gestionnaire de paquets:** <https://formulae.brew.sh/formula/goctl>
- **Version:** 1.10.2
- **Résumé source:** Generates server-side and client-side code for web and RPC services
- **Page d'accueil:** <https://go-zero.dev>
- **Dépôt:** <https://github.com/zeromicro/go-zero>
- **Docs amont:** <https://go-zero.dev>
- **Licence:** MIT
- **Archive source:** <https://github.com/zeromicro/go-zero/archive/refs/tags/tools/goctl/v1.10.2.tar.gz>
- **Dernière mise à jour:** 2026-08-01T06:42:22Z
- **Généré:** 2026-08-04T22:13:35+00:00

## exécutables

- goctl (cli)
- goctl (alias)

## Dépendances de compilation

- go

## Comportement d'installation

- hook post-installation: non défini
- Bouteille: disponible sur arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Version et fraîcheur

- page générée: 2026-08-04
- version du gestionnaire: 1.10.2
- gestionnaire mis à jour: 2026-08-01
- données locales: OK
- dépôt amont: https://github.com/zeromicro/go-zero
- dernière version détectée: tools/goctl/v1.10.2 (à jour)
## Historique du projet et usages

goctl is the code-generation CLI for the go-zero Go microservices framework. It turns go-zero's API and RPC descriptions into server code, client code, models, Dockerfiles, Kubernetes manifests, templates, and other project scaffolding.

### Historique du projet

The go-zero repository was created in August 2020. Its README says the framework grew from an early 2018 transition from a Java and MongoDB monolith to Go microservices, with goctl serving as the code-generation tool around go-zero's API description syntax.

goctl evolved as a tool module inside the go-zero repository. Official documentation describes it as go-zero's code generation tool for HTTP services, gRPC services, models, Dockerfiles, Kubernetes manifests, and related workflow tasks.

### Historique d'adoption

go-zero became a large Go framework project, with GitHub repository metadata showing more than thirty thousand stars by June 2026. goctl's adoption is tied to that framework: users installing go-zero for API and RPC services also install goctl to generate the boilerplate that keeps services consistent.

Distribution follows both Go and package-manager norms. The official README documents `go install github.com/zeromicro/go-zero/tools/goctl@...`, Homebrew installation with `brew install goctl`, and a Docker image path.

### Modes d'utilisation

Typical usage begins by creating a `.api` file, running `goctl api go -api ... -dir ...`, and then running the generated Go service. The README's quick start shows goctl generating handler, logic, config, service-context, and type files for an HTTP API.

The CLI reference groups goctl commands around API generation, RPC generation, model generation, Docker, Kubernetes, environment checks, config, templates, naming style, Swagger, upgrades, migration, shell completion, and bug reporting.

### Pourquoi les passionnés de paquets s'y intéressent

Package nerds care about goctl because it is a generator packaged separately from the framework it serves. That split lets a team pin or install the CLI through Homebrew, Go tooling, or Docker while generated services depend on normal Go modules.

It is also a good example of spec-driven development in a package ecosystem: the `.api` file becomes a compact source artifact, and goctl expands it into a repeatable service layout.

### Chronologie

- 2018: go-zero's README describes the internal microservices transition that motivated the framework.
- 2020-08: go-zero GitHub repository created.
- 2025-10: goctl v1.9.2 release tag published under tools/goctl.
- 2026-02: goctl v1.10.0 release tag published.
- 2026-03: goctl v1.10.1 release tag published.

### Related projects

- go-zero is the framework goctl serves.
- Protocol Buffers and gRPC are part of the RPC generation workflow.
- mcp-zero, ai-context, and zero-skills are related go-zero projects for AI-assisted framework-compliant development.

### Sources

- <https://api.github.com/repos/zeromicro/go-zero>
- <https://api.github.com/repos/zeromicro/go-zero/releases>
- <https://github.com/zeromicro/go-zero>
- <https://github.com/zeromicro/go-zero/releases>
- <https://go-zero.dev/getting-started/>
- <https://go-zero.dev/reference/cli-guide/>


## Notes de sécurité

broad file, network, media, or database tool signal.

- **Risque Geiger:** blue / moyen
- broad file, network, media, or database tool signal

## Détails de la base source

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** goctl
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Autres enregistrements de gestionnaires de paquets

- Nix - goctl: normalized package name match | nixpkgs package indexes: pkgs/by-name/go/goctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Liens liés

- [Secret-risk packages](https://pkg.so/fr/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/fr/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/fr/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/fr/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://pkg.so/fr/brew/go/) - Build dependency declared by Homebrew.
- [tproxy](https://pkg.so/fr/brew/tproxy/) - Shares the same upstream homepage.
- [protoc-gen-go-grpc](https://pkg.so/fr/brew/protoc-gen-go-grpc/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, go, rpc.
- [kitex](https://pkg.so/fr/brew/kitex/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, go, rpc.
- [fbthrift](https://pkg.so/fr/brew/fbthrift/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, rpc.
- [thrift](https://pkg.so/fr/brew/thrift/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, rpc.
- [protoc-gen-go](https://pkg.so/fr/brew/protoc-gen-go/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, go.
- [mockery](https://pkg.so/fr/brew/mockery/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, go.
- [sqlc](https://pkg.so/fr/brew/sqlc/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, go.
- [go-bindata](https://pkg.so/fr/brew/go-bindata/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, go.
- [ts-web-scraper](https://pkg.so/fr/npm/ts-web-scraper/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, client, client-side, code, code-generation.

## Combined YAML source

View the package source record on GitHub. [combined/goctl.yml](https://github.com/mxcl/pkgdb/blob/main/combined/goctl.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph