d112dab0d1
- Move command docs to docs/cmd/ for better organization - Add work.md: multi-repo operations (health, issues, reviews, etc.) - Add docs.md: documentation management (list, sync) - Add templates.md: LinuxKit template management - Add setup.md: clone repos from registry - Update index.md with full command reference Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
112 lines
1.9 KiB
Markdown
112 lines
1.9 KiB
Markdown
# core search & install
|
|
|
|
Search GitHub for repositories and install them locally.
|
|
|
|
## core search
|
|
|
|
Search GitHub for repositories matching a pattern.
|
|
|
|
```bash
|
|
core search <pattern> [flags]
|
|
```
|
|
|
|
### Flags
|
|
|
|
| Flag | Description |
|
|
|------|-------------|
|
|
| `--org` | Search within a specific organization |
|
|
| `--limit` | Maximum results (default: 10) |
|
|
| `--language` | Filter by programming language |
|
|
|
|
### Examples
|
|
|
|
```bash
|
|
# 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.
|
|
|
|
```bash
|
|
core install <repo> [flags]
|
|
```
|
|
|
|
### Flags
|
|
|
|
| Flag | Description |
|
|
|------|-------------|
|
|
| `--path` | Destination directory (default: current dir) |
|
|
| `--branch` | Clone specific branch |
|
|
| `--depth` | Shallow clone depth |
|
|
|
|
### Examples
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
gh auth status
|
|
gh auth login # if not authenticated
|
|
```
|
|
|
|
## Workflow Example
|
|
|
|
```bash
|
|
# 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
|
|
|
|
- [setup command](setup.md) - Clone all repos from registry
|
|
- [doctor command](doctor.md) - Check environment
|