// Edit dagger.gen.go output, Go templates (object.go.tmpl, defs.go.tmpl), invoke() dispatch, SDK interfaces (CodeGenerator, ClientGenerator), `dagger develop`, `dagger client install`. Keywords: codegen, SDK, bindings, templates, internal/dagger, dag.*, ModuleMainSrc
| name | dagger-codegen |
| description | Edit dagger.gen.go output, Go templates (object.go.tmpl, defs.go.tmpl), invoke() dispatch, SDK interfaces (CodeGenerator, ClientGenerator), `dagger develop`, `dagger client install`. Keywords: codegen, SDK, bindings, templates, internal/dagger, dag.*, ModuleMainSrc |
dagger.gen.go or internal/dagger/dagger.gen.go outputcmd/codegen/generator/go/templates/core/sdk.godagger develop, dagger call, or dagger client install"Codegen" means 4 different things in Dagger:
| # | Name | Trigger | Key Files |
|---|---|---|---|
| 1 | In-Module Bindings | dagger develop | cmd/codegen/generator/go/templates/ |
| 2 | Runtime Dispatch | Module startup | cmd/codegen/generator/go/templates/modules.go:140 |
| 3 | SDK Libraries | go generate | sdk/go/generate.go |
| 4 | Generated Clients | dagger client install | _dagger.gen.go/client.go.tmpl |
Know which one you're dealing with before editing.
| To change... | Edit |
|---|---|
| Generated method signatures | cmd/codegen/generator/go/templates/src/_types/object.go.tmpl |
| Generated type definitions | cmd/codegen/generator/go/templates/src/_types/*.go.tmpl |
Module invoke() dispatch | cmd/codegen/generator/go/templates/modules.go:140 |
Standalone client Connect() | cmd/codegen/generator/go/templates/src/_dagger.gen.go/client.go.tmpl |
| Template functions | cmd/codegen/generator/go/templates/functions.go:54 |
| SDK interfaces | core/sdk.go:20 (ClientGenerator), :93 (CodeGenerator) |
| Built-in SDK list | core/sdk/consts.go |
| Python output | sdk/python/codegen/src/codegen/generator.py |
Load based on specific need:
| Need | Load |
|---|---|
| Understanding the 4 codegen types | codegen-types.md |
| SDK architecture, interfaces, Go special case | sdk-architecture.md |
| Go template conditionals, two-pass generation | go-templates.md |
dagger client install internals | generated-clients.md |
Covers Dagger Engine caching internals including cache key derivation, invalidation, and the immutable DAG model. Use when debugging cache misses, unexpected invalidations, or implementing caching-related engine features.
How to test Dagger engine changes. Covers manual e2e testing via the playground (bootstrapping a dev engine from source, running commands inside it, capturing crash logs) and running the integration test suite. Use when modifying engine code (engine/server, core/, dagql/) and needing to verify changes work. Triggers on: testing engine changes, dev engine, playground, e2e test, engine crash, debug engine, manual testing, verify engine fix.
Handle quick, repeatable Dagger repository maintenance chores. Use when the user asks for small operational changes and wants the same established edits and commit style applied quickly.
Write design proposals for Dagger features. Use when asked to draft, review, or iterate on Dagger design documents, RFCs, or proposals.