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

agentdex

package module

Go to main page

Versions in this module

v1

v1.1.0

Aug 16, 2026

Changes in this version

type WarningKind

+ const WarnUnknownBinPath

v1.0.0

Aug 10, 2026

v0

v0.0.2

Aug 4, 2026

Changes in this version

+ var ErrAgentUnknown = errors.New("unknown agent id")

+ var ErrCatalogInvalid = errors.New("agentdex catalog invalid")

+ var ErrCatalogUnavailable = errors.New("agentdex catalog unavailable")

+ var ErrMalformedModelID = errors.New("malformed model id")

+ var ErrModelsSchema = modelsdev.ErrModelsSchema

+ var ErrModelsUnavailable = errors.New("models.dev unavailable")

+ var ErrNotFound = errors.New("not found")

+ var ErrProvidersNotAllowed = errors.New("providers not allowed for home-provider agent")

+ var ErrProvidersRequired = errors.New("providers required for agnostic agent")

+ var ErrUnknownProvider = errors.New("unknown provider id")

+ type Agent struct

+ Detection Detection

+ Enrichment EnrichmentState

+ ModelCount int

+ Models []Model

+ ProviderEnv map[string]bool

+ ResolvedProviders []string

+ type AgentDetail struct

+ Coverage ProviderCoverage

+ Warnings []Warning

+ type AgentGetQuery struct

+ Enrich Enrich

+ Providers []string

+ type AgentQuery struct

+ Enrich Enrich

+ Filter string

+ Installed bool

+ Providers []string

+ type AgentService struct

+ func (s AgentService) Get(ctx context.Context, id string, q AgentGetQuery) (AgentDetail, error)

+ func (s AgentService) List(ctx context.Context, q AgentQuery) (Result[Agent], error)

+ type CatalogInfo struct

+ Dir string

+ Module string

+ Source CatalogSource

+ Stale bool

+ Version string

+ type CatalogSource int

+ const CatalogSourceDir

+ const CatalogSourceRegistry

+ func (s CatalogSource) String() string

+ type CoverageStatus int

+ const CoverageAllPresent

+ const CoverageNonePresent

+ const CoverageNotProbed

+ const CoverageSchemaDrift

+ const CoverageSomePresent

+ const CoverageUnreachable

+ func (s CoverageStatus) String() string

+ type Detection struct

+ BinaryPath string

+ Config ResolvedPaths

+ Found bool

+ Skills SkillsPaths

+ Version string

+ type Enrich int

+ const EnrichCount

+ const EnrichFull

+ const EnrichNone

+ const EnrichProviders

+ func (e Enrich) String() string

+ type EnrichmentState int

+ const EnrichmentApplied

+ const EnrichmentDegraded

+ const EnrichmentNotApplicable

+ const EnrichmentNotRequested

+ func (s EnrichmentState) String() string

+ type Index struct

+ Agents AgentService

+ Models ModelService

+ Providers ProviderService

+ func Open(opts ...Option) (*Index, error)

+ func (x *Index) CatalogInfo(ctx context.Context) (CatalogInfo, error)

+ func (x *Index) CatalogStale(ctx context.Context) (bool, error)

+ func (x *Index) ModelsStale(ctx context.Context) (bool, error)

+ func (x *Index) Refresh(ctx context.Context, t Target) (Refreshed, error)

+ type KnownAgent struct

+ Agnostic bool

+ Bin string

+ CatalogProviders []string

+ Description string

+ Homepage string

+ ID string

+ Name string

+ type Model struct

+ CanonicalID string

+ Provider string

+ type ModelQuery struct

+ Filter string

+ Scope ModelScope

+ type ModelScope struct

+ Agent string

+ Providers []string

+ type ModelService struct

+ func (s ModelService) Get(ctx context.Context, composite string) (Model, error)

+ func (s ModelService) List(ctx context.Context, q ModelQuery) (Result[Model], error)

+ type Option func(*options)

+ func WithBinPaths(m map[string]string) Option

+ func WithCacheDir(dir string) Option

+ func WithCatalogDir(dir string) Option

+ func WithCatalogModule(path string) Option

+ func WithCatalogTTL(d time.Duration) Option

+ func WithEnvLookup(fn func(string) (string, bool)) Option

+ func WithHTTPClient(hc *http.Client) Option

+ func WithLogger(l *slog.Logger) Option

+ func WithLookPath(fn func(string) (string, error)) Option

+ func WithModelsTTL(d time.Duration) Option

+ func WithModelsURL(url string) Option

+ func WithSearchDirs(dirs ...string) Option

+ func WithWorkingDir(dir string) Option

+ type PathEntry struct

+ Exists bool

+ Path string

+ type Provider struct

+ EnvPresent map[string]bool

+ type ProviderCoverage struct

+ Absent []string

+ Err error

+ Present []string

+ Status CoverageStatus

+ type ProviderQuery struct

+ Filter string

+ type ProviderService struct

+ func (s ProviderService) Get(ctx context.Context, id string) (Provider, error)

+ func (s ProviderService) List(ctx context.Context, q ProviderQuery) (Result[Provider], error)

+ type Refreshed struct

+ Catalog bool

+ Models bool

+ type ResolvedPaths struct

+ Global string

+ GlobalExists bool

+ Local string

+ LocalExists bool

+ type Result struct

+ Items []T

+ Warnings []Warning

+ type SkillsPaths struct

+ Global SkillsScope

+ Local SkillsScope

+ type SkillsScope struct

+ Agents PathEntry

+ Alternatives []PathEntry

+ Native PathEntry

+ Primary PathEntry

+ type Target int

+ const TargetAll

+ const TargetCatalog

+ const TargetModels

+ func (t Target) String() string

+ type Warning struct

+ Kind WarningKind

+ Msg string

+ type WarningKind int

+ const WarnModelsSchemaDrift

+ const WarnModelsStale

+ const WarnModelsUnreachable

+ const WarnNotInstalled

+ const WarnProvidersRequired

+ const WarnSomeProvidersAbsent

+ const WarnStaleCatalog

+ func (k WarningKind) String() string