cli/docs/cmd/setup/index.md

# core setup

Clone all repositories from the registry.

## Usage

```bash
core setup [flags]
```

## Flags

| Flag | Description |
|------|-------------|
| `--registry` | Path to repos.yaml |
| `--path` | Base directory for cloning (default: current dir) |
| `--ssh` | Use SSH URLs instead of HTTPS |

## Examples

```bash
# Clone all repos from registry
core setup

# Clone to specific directory
core setup --path ~/Code/host-uk

# Use SSH for cloning
core setup --ssh
```

## Registry Format

The registry file (`repos.yaml`) defines repositories:

```yaml
repos:
  - name: core
    url: https://github.com/host-uk/core
    description: Go CLI for the host-uk ecosystem

  - name: core-php
    url: https://github.com/host-uk/core-php
    description: PHP/Laravel packages

  - name: core-images
    url: https://github.com/host-uk/core-images
    description: Docker and LinuxKit images

  - name: core-api
    url: https://github.com/host-uk/core-api
    description: API service
```

## Output

```
Setting up host-uk workspace...

Cloning repositories:
  [1/4] core............... ✓
  [2/4] core-php........... ✓
  [3/4] core-images........ ✓
  [4/4] core-api........... ✓

Done! 4 repositories cloned to ~/Code/host-uk
```

## Finding Registry

Core looks for `repos.yaml` in:

1. Current directory
2. Parent directories (up to 5 levels)
3. `~/.core/repos.yaml`

## After Setup

```bash
# Check health of all repos
core dev health

# Pull latest changes
core dev pull --all

# Full workflow (status + commit + push)
core dev work
```

## See Also

- [work commands](../dev/work/) - Multi-repo operations
- [search command](../pkg/search/) - Find and install repos