cli/docs/cmd/pkg/search/index.md
Snider 13561b1de6 docs: fix command prefixes across documentation
- core search → core pkg search
- core install → core pkg install
- core templates → core vm templates
- core run → core vm run
- --target → --output in docs sync

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:46:24 +00:00

2 KiB

core pkg search & core pkg install

Search GitHub for repositories and install them locally.

Search GitHub for repositories matching a pattern.

core pkg search <pattern> [flags]

Flags

Flag Description
--org Search within a specific organization
--limit Maximum results (default: 10)
--language Filter by programming language

Examples

# Search by pattern
core pkg search "cli tool"

# Search within organization
core pkg search --org host-uk

# Search with language filter
core pkg search --org host-uk --language go

# Search all core-* repos
core pkg search "core-" --org host-uk

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

core pkg install

Clone a repository from GitHub.

core pkg install <repo> [flags]

Flags

Flag Description
--path Destination directory (default: current dir)
--branch Clone specific branch
--depth Shallow clone depth

Examples

# Install by full name
core pkg install host-uk/core

# Install to specific path
core pkg install host-uk/core --path ~/Code/host-uk

# Install specific branch
core pkg install host-uk/core --branch dev

# Shallow clone
core pkg install host-uk/core --depth 1

Authentication

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

gh auth status
gh auth login  # if not authenticated

Workflow Example

# Find repositories
core pkg search --org host-uk

# Install one
core pkg install host-uk/core-php --path ~/Code/host-uk

# Check setup
core doctor

See Also