searchLast updated on
Last updated on
Search for artifacts in registries
Searches for artifacts in a registry.
Usage
paradoc search [query] [options]Arguments
| Argument | Description |
|---|---|
query | Search query (matches name, title, or description) |
Options
| Option | Description |
|---|---|
--registry <namespace> | Registry namespace to search (default: the only configured registry) |
--kind <kind> | Filter by artifact kind: form, document, checklist, bundle |
--tags <tags> | Filter by tags (comma-separated) |
--json | Output as JSON |
Description
The search command queries a registry's index to find matching artifacts. You can filter results by kind, tags, or a text query that matches against artifact names, titles, and descriptions. Each result shows the release you get by default, and the editions and versions the registry lists for the artifact. To install one of them, see the reference forms in add.
There is no default registry. Without --registry, it searches the one registry you have configured. With no registry configured, it fails and tells you to pass --registry or run paradoc registry add. With several configured, it fails and lists them so you can pick one with --registry.
A namespace must be configured first with paradoc registry add; an unconfigured one fails and prints the command to run. @paradoc is reserved for the Paradoc registry, which is not available yet. When the registry host cannot be reached, the command fails and names it.
Examples
Search all artifacts:
paradoc searchSearch with a query:
paradoc search "lease agreement"Filter by kind:
paradoc search --kind formFilter by tags:
paradoc search --tags legal,real-estateSearch a specific registry:
paradoc search --registry @acme "tax"Output as JSON:
paradoc search --jsonOutput
Found 3 artifacts:
@acme/pet-policy v1.1.0
Pet Policy
Rules for keeping pets in a rental unit
form
Versions: 1.1.0 (latest), 2.0.0-beta.1, 1.0.0
@acme/residential-lease v1.0.0
Residential Lease Agreement
Standard residential property lease agreement between landlord and tenant
form · #lease #residential #rental #agreement · 2 layers
Versions: 1.0.0 (latest)
@acme/w4 2024 v1.1.0
Employee's Withholding Certificate
form · #irs #tax #payroll
Editions:
2024 (current) 2024: 1.1.0 (latest), 1.0.0
2025 2025: 1.0.0 (latest)
Run paradoc add @acme/<name> to install an artifact, or @acme/<name>/<edition>@<version> for one release.The first line of a result is the release you get by default. An artifact that has editions lists each one with its key, the issuer's label, and its versions.
See also
Use --no-cache to bypass cached registry search results.