cli/docs/cmd/dev/work/index.md

core dev work

Multi-repo git operations for managing the host-uk organization.

Overview

The core dev work command and related subcommands help manage multiple repositories in the host-uk ecosystem simultaneously.

Commands

Command	Description
core dev work	Full workflow: status + commit + push
core dev work --status	Status table only
core dev work --commit	Use Claude to commit dirty repos
core dev health	Quick health check across all repos
core dev commit	Claude-assisted commits across repos
core dev push	Push commits across all repos
core dev pull	Pull updates across all repos
core dev issues	List open issues across all repos
core dev reviews	List PRs needing review
core dev ci	Check CI status across all repos
core dev impact	Show impact of changing a repo

core dev work

Manage git status, commits, and pushes across multiple repositories.

core dev work [flags]

Reads repos.yaml to discover repositories and their relationships. Shows status, optionally commits with Claude, and pushes changes.

Flags

Flag	Description
--registry	Path to repos.yaml (auto-detected if not specified)
--status	Show status only, don't push
--commit	Use Claude to commit dirty repos before pushing

Examples

# Full workflow
core dev work

# Status only
core dev work --status

# Commit and push
core dev work --commit

core dev health

Quick health check showing summary of repository health across all repos.

core dev health [flags]

Flags

Flag	Description
--registry	Path to repos.yaml (auto-detected if not specified)
--verbose	Show detailed breakdown

Output shows:

• Total repos
• Dirty repos
• Unpushed commits
• Repos behind remote

Examples

# Quick summary
core dev health

# Detailed breakdown
core dev health --verbose

core dev issues

List open issues across all repositories.

core dev issues [flags]

Fetches open issues from GitHub for all repos in the registry. Requires the gh CLI to be installed and authenticated.

Flags

Flag	Description
--registry	Path to repos.yaml (auto-detected if not specified)
--assignee	Filter by assignee (use @me for yourself)
--limit	Max issues per repo (default: 10)

Examples

# List all open issues
core dev issues

# Filter by assignee
core dev issues --assignee @me

# Limit results
core dev issues --limit 5

core dev reviews

List pull requests needing review across all repos.

core dev reviews [flags]

Fetches open PRs from GitHub for all repos in the registry. Shows review status (approved, changes requested, pending). Requires the gh CLI to be installed and authenticated.

Flags

Flag	Description
--registry	Path to repos.yaml (auto-detected if not specified)
--all	Show all PRs including drafts
--author	Filter by PR author

Examples

# List PRs needing review
core dev reviews

# Show all PRs including drafts
core dev reviews --all

# Filter by author
core dev reviews --author username

core dev commit

Create commits across repos with Claude assistance.

core dev commit [flags]

Uses Claude to create commits for dirty repos. Shows uncommitted changes and invokes Claude to generate commit messages.

Flags

Flag	Description
--registry	Path to repos.yaml (auto-detected if not specified)
--all	Commit all dirty repos without prompting

Examples

# Commit with prompts
core dev commit

# Commit all automatically
core dev commit --all

core dev push

Push commits across all repos.

core dev push [flags]

Pushes unpushed commits for all repos. Shows repos with commits to push and confirms before pushing.

Flags

Flag	Description
--registry	Path to repos.yaml (auto-detected if not specified)
--force	Skip confirmation prompt

Examples

# Push with confirmation
core dev push

# Skip confirmation
core dev push --force

core dev pull

Pull updates across all repos.

core dev pull [flags]

Pulls updates for all repos. By default only pulls repos that are behind. Use --all to pull all repos.

Flags

Flag	Description
--registry	Path to repos.yaml (auto-detected if not specified)
--all	Pull all repos, not just those behind

Examples

# Pull repos that are behind
core dev pull

# Pull all repos
core dev pull --all

core dev ci

Check GitHub Actions workflow status across all repos.

core dev ci [flags]

Fetches GitHub Actions workflow status for all repos. Shows latest run status for each repo. Requires the gh CLI to be installed and authenticated.

Flags

Flag	Description
--registry	Path to repos.yaml (auto-detected if not specified)
--branch	Filter by branch (default: main)
--failed	Show only failed runs

Examples

# Show CI status for all repos
core dev ci

# Show only failed runs
core dev ci --failed

# Check specific branch
core dev ci --branch develop

core dev impact

Show the impact of changing a repository.

core dev impact <repo> [flags]

Analyzes the dependency graph to show which repos would be affected by changes to the specified repo.

Flags

Flag	Description
--registry	Path to repos.yaml (auto-detected if not specified)

Examples

# Show impact of changing core-php
core dev impact core-php

Registry

These commands use repos.yaml to know which repos to manage. See repos.yaml for format.

Use core setup to clone all repos from the registry.

See Also

• setup command - Clone repos from registry
• search command - Find and install repos