apkg search

The search command queries the registry and lists matching packages with their name, version, type, and description.

Synopsis

apkg search <query> [--limit <n>] [--json] [--registry <URL>]

Arguments

Argument	Description
`<query>`	Search term to look for

Options

Option	Default	Description
`--limit <n>`	`20`	Maximum number of results to return
`--json`	—	Output results as JSON
`--registry <URL>`	—	Override the registry URL for this search

Output

In the default human-readable mode, each result shows:

  @acme/code-reviewer 1.2.0 [skill]
    AI-powered code review

With --json, the output is a JSON object with results and total fields:

{
  "results": [
    {
      "name": "@acme/code-reviewer",
      "version": "1.2.0",
      "description": "AI-powered code review",
      "type": "skill"
    }
  ],
  "total": 1
}

Examples

Search for code review packages:

apkg search code-review

Limit results to 5:

apkg search agent --limit 5

Get results as JSON (useful for scripting):

apkg search summarize --json

Command	Description
`info`	Show detailed metadata for a package
`add`	Add a package to your dependencies