go/docs/cmd/dev/example.md
Snider dea8f59c10 docs: sync core dev and core go with CLI
Updated by technical writer agents:
- core dev: added task management, api, sync, ci commands
- core dev: fixed all flag discrepancies
- core go: added work subcommands (init, sync, use)
- core go: added missing flags (--json, --check, --open, --threshold)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 16:10:23 +00:00

2.5 KiB

Dev Examples

Multi-Repo Workflow

# Quick status
core dev health

# Detailed breakdown
core dev health --verbose

# Full workflow
core dev work

# Status only
core dev work --status

# Commit and push
core dev work --commit

# Commit dirty repos
core dev commit

# Commit all without prompting
core dev commit --all

# Push unpushed
core dev push

# Push without confirmation
core dev push --force

# Pull behind repos
core dev pull

# Pull all repos
core dev pull --all

GitHub Integration

# Open issues
core dev issues

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

# Limit results
core dev issues --limit 5

# PRs needing review
core dev reviews

# All PRs including drafts
core dev reviews --all

# Filter by author
core dev reviews --author username

# CI status
core dev ci

# Only failed runs
core dev ci --failed

# Specific branch
core dev ci --branch develop

Dependency Analysis

# What depends on core-php?
core dev impact core-php

Task Management

# List tasks
core dev tasks

# Filter by status and priority
core dev tasks --status pending --priority high

# Filter by labels
core dev tasks --labels bug,urgent

# Show task details
core dev task abc123

# Auto-select highest priority task
core dev task --auto

# Claim a task
core dev task abc123 --claim

# Update task status
core dev task:update abc123 --status in_progress

# Add progress notes
core dev task:update abc123 --progress 50 --notes 'Halfway done'

# Complete a task
core dev task:complete abc123 --output 'Feature implemented'

# Mark as failed
core dev task:complete abc123 --failed --error 'Build failed'

# Commit with task reference
core dev task:commit abc123 -m 'add user authentication'

# Commit with scope and push
core dev task:commit abc123 -m 'fix login bug' --scope auth --push

# Create PR for task
core dev task:pr abc123

# Create draft PR with labels
core dev task:pr abc123 --draft --labels 'enhancement,needs-review'

Service API Management

# Synchronize public service APIs
core dev sync

# Or using the api command
core dev api sync

Dev Environment

# First time setup
core dev install
core dev boot

# Open shell
core dev shell

# Mount and serve
core dev serve

# Run tests
core dev test

# Sandboxed Claude
core dev claude

Configuration

repos.yaml:

org: host-uk
repos:
  core-php:
    type: package
    description: Foundation framework
  core-tenant:
    type: package
    depends: [core-php]

~/.core/config.yaml:

version: 1
images:
  source: auto