core/cli

Snider 76872efbd7 docs: complete CLI documentation sync

- pkg search: add --pattern, --type, --refresh, --limit, --org flags
- sdk: remove generate (use core build sdk), keep only diff/validate
- vm run: add --ssh-port, --name, fix defaults
- TODO.md: all gaps resolved

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-29 16:27:39 +00:00

1.4 KiB

Raw Blame History

core pkg search

Search GitHub for repositories matching a pattern.

Uses gh CLI for authenticated search. Results are cached for 1 hour.

Usage

core pkg search [flags]

Flags

Flag	Description
`--pattern`	Repo name pattern (* for wildcard)
`--org`	GitHub organization (default: host-uk)
`--type`	Filter by type in name (mod, services, plug, website)
`--limit`	Max results (default: 50)
`--refresh`	Bypass cache and fetch fresh data

Examples

# List all host-uk repos
core pkg search

# Search for core-* repos
core pkg search --pattern "core-*"

# Search different org
core pkg search --org mycompany

# Filter by type
core pkg search --type services

# Bypass cache
core pkg search --refresh

# Combine filters
core pkg search --pattern "core-*" --type mod --limit 20

Output

Found 5 repositories:

  host-uk/core
    Go CLI for the host-uk ecosystem
    ★ 42  Go  Updated 2 hours ago

  host-uk/core-php
    PHP/Laravel packages for Core
    ★ 18  PHP  Updated 1 day ago

  host-uk/core-images
    Docker and LinuxKit images
    ★ 8  Dockerfile  Updated 3 days ago

Authentication

Uses GitHub CLI (gh) authentication. Ensure you're logged in:

gh auth status
gh auth login  # if not authenticated

1.4 KiB Raw Blame History