Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

invoke

package

Go to main page

Versions in this module

v1

v1.4.15

Oct 19, 2026

v1.4.14

Oct 12, 2026

Changes in this version

+ const MaxSecretEnvBytes

+ const SecretsEnv

+ func RestoreSecretArgv(argv []string) (out []string, values []string, err error)

type Options

+ KillDelay time.Duration

type Result

+ Confirmation bool

+ type SecretBundle struct

+ Nonce string

+ Values []string

+ func BuildArgvSecrets(cmd *cmdregistry.Command, r Request, transport string) ([]string, *SecretBundle, error)

type Spec

+ KillDelay time.Duration

+ Secrets *SecretBundle

v1.4.13

Oct 11, 2026

Changes in this version

+ const CauseTailBytes

+ const ConfirmKindPlan

+ const ConfirmKindRequest

+ const DeadlineEnv

+ const DecisionConfirm

+ const DecisionRefuse

+ const DecisionRun

+ const DefaultTimeout

+ const InvokedByEnv

+ const MaxArgvBytes

+ const MaxElementBytes

+ const MaxRequestBytes

+ const MaxStdoutBytes

+ const PathEnv

+ const Redacted

+ const SelfExecOverrideEnv

+ const StderrRingBytes

+ const TokenEnv

+ const TransportHTTP

+ const TransportHTTPStream

+ const TransportMCP

+ func BuildArgv(cmd *cmdregistry.Command, r Request) ([]string, error)

+ func BuildArgvFor(cmd *cmdregistry.Command, r Request, transport string) ([]string, error)

+ func CheckFreeForm(reg *cmdregistry.Registry, cmd *cmdregistry.Command, r Request) error

+ func DefaultAuditPath() (string, error)

+ func ExposedFlags(cmd *cmdregistry.Command, transport string) []cmdregistry.Flag

+ func Exposure(cmd *cmdregistry.Command, transport string, set map[string]bool) (bool, string)

+ func FreeFormArgv(reg *cmdregistry.Registry, cmd *cmdregistry.Command) bool

+ func IsLeaf(reg *cmdregistry.Registry, cmd *cmdregistry.Command) bool

+ func ParamsSchema(cmd *cmdregistry.Command) map[string]any

+ func ParamsSchemaIn(reg *cmdregistry.Registry, cmd *cmdregistry.Command) map[string]any

+ func RequestID(path string, cmd *cmdregistry.Command, r Request) string

+ func SecretValues(cmd *cmdregistry.Command, r Request) []string

+ func SelfExecutable() (string, error)

+ func SetFlags(r Request) map[string]bool

+ type Confirmation struct

+ Confirm string

+ ConfirmationRequired bool

+ Kind string

+ Plan any

+ Reason string

+ SideEffect string

+ type Decision struct

+ ConfirmKind string

+ Confirmation *Confirmation

+ Flags []string

+ Kind string

+ Refusal error

+ Result *Result

+ SideEffect string

+ func Gate(ctx context.Context, reg *cmdregistry.Registry, cmd *cmdregistry.Command, ...) (Decision, error)

+ type Guard struct

+ Now func() time.Time

+ func NewGuard(auditPath string) *Guard

+ type Options struct

+ Dir string

+ Guard *Guard

+ Stdout io.Writer

+ Surface string

+ Timeout time.Duration

+ Transport string

+ type Request struct

+ Args []string

+ Argv []string

+ Confirm string

+ Flags map[string]any

+ func DecodeRequest(data []byte) (Request, error)

+ func RedactRequest(cmd *cmdregistry.Command, r Request) Request

+ type Result struct

+ ErrorCode string

+ ExitCode int

+ RequestID string

+ Stderr []byte

+ Stdout []byte

+ StdoutTruncated bool

+ TimedOut bool

+ func Exec(ctx context.Context, s Spec) (Result, error)

+ func Invoke(ctx context.Context, reg *cmdregistry.Registry, path string, req Request, ...) (Result, error)

+ type Spec struct

+ Argv []string

+ Dir string

+ Path string

+ Stdout io.Writer

+ Timeout time.Duration

+ Transport string