cli/docs/cmd/dev/work/index.md
Snider 059a0ba897 docs: fix broken links and update command references
- Update docs/index.md with correct directory links
- Fix relative path errors in subcommand docs
- Update core release → core ci references
- Expand vm/index.md with full command documentation
- Fix See Also sections across all docs

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

3 KiB

core work

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

Overview

The work command and related commands (health, issues, reviews, commit, push, pull, impact, ci) help manage multiple repositories in the host-uk ecosystem simultaneously.

Commands

Command Description
core work Multi-repo git operations
core health Quick health check across all repos
core issues List open issues across all repos
core reviews List PRs needing review
core commit Claude-assisted commits across repos
core push Push commits across all repos
core pull Pull updates across all repos
core impact Show impact of changing a repo
core ci Check CI status across all repos

core health

Quick health check showing status of all repos.

core health

Output shows:

  • Git status (clean/dirty)
  • Current branch
  • Commits ahead/behind remote
  • CI status

core issues

List open issues across all repositories.

core issues [flags]

Flags

Flag Description
--assignee Filter by assignee
--label Filter by label
--limit Max issues per repo

core reviews

List pull requests needing review.

core reviews [flags]

Shows PRs where:

  • You are a requested reviewer
  • PR is open and not draft
  • CI is passing

core commit

Create commits across repos with Claude assistance.

core commit [flags]

Flags

Flag Description
--message Commit message (auto-generated if not provided)
--all Commit in all dirty repos

Claude analyzes changes and suggests conventional commit messages.

core push

Push commits across all repos.

core push [flags]

Flags

Flag Description
--all Push all repos with unpushed commits
--force Force push (use with caution)

core pull

Pull updates across all repos.

core pull [flags]

Flags

Flag Description
--all Pull all repos
--rebase Rebase instead of merge

core impact

Show the impact of changing a repository.

core impact <repo>

Shows:

  • Dependent repos
  • Reverse dependencies
  • Potential breaking changes

core ci

Check CI status across all repos.

core ci [flags]

Flags

Flag Description
--watch Watch for status changes
--failing Show only failing repos

Registry

These commands use repos.yaml to know which repos to manage:

repos:
  - name: core
    path: ./core
    url: https://github.com/host-uk/core
  - name: core-php
    path: ./core-php
    url: https://github.com/host-uk/core-php

Use core setup to clone all repos from the registry.

See Also