cli/docs/search.md
Snider 229cde534d docs: add comprehensive CLI documentation
- Add sdk.md: SDK generation and API diff commands
- Add dev.md: DevOps portable environment (100+ tools)
- Add doctor.md: Environment health check
- Add search.md: GitHub search and install commands
- Update build.md: Add code signing flags (--no-sign, --notarize)
- Update release.md: Add --target sdk flag
- Update index.md: Organize commands by category

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 09:34:57 +00:00

1.9 KiB

core search & install

Search GitHub for repositories and install them locally.

Search GitHub for repositories matching a pattern.

core 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 search "cli tool"

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

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

# Search all core-* repos
core 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 install

Clone a repository from GitHub.

core 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 install host-uk/core

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

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

# Shallow clone
core 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 search --org host-uk

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

# Check setup
core doctor

See Also