Core Go

Core is a Go framework for the host-uk ecosystem - build, release, and deploy Go, Wails, PHP, and container workloads.

Installation

# Via Go (recommended)
go install github.com/host-uk/core/cmd/core@latest

# Or download binary from releases
curl -Lo core https://github.com/host-uk/core/releases/latest/download/core-$(go env GOOS)-$(go env GOARCH)
chmod +x core && sudo mv core /usr/local/bin/

# Verify
core doctor

See Getting Started for all installation options including building from source.

Command Reference

See CLI for full command documentation.

Command	Description
go	Go development (test, fmt, lint, cov)
php	Laravel/PHP development
build	Build Go, Wails, Docker, LinuxKit projects
ci	Publish releases (dry-run by default)
sdk	SDK generation and validation
dev	Multi-repo workflow + dev environment
pkg	Package search and install
vm	LinuxKit VM management
docs	Documentation management
setup	Clone repos from registry
doctor	Check development environment

Quick Start

# Go development
core go test              # Run tests
core go test --coverage   # With coverage
core go fmt               # Format code
core go lint              # Lint code

# Build
core build                # Auto-detect and build
core build --targets linux/amd64,darwin/arm64

# Release (dry-run by default)
core ci                   # Preview release
core ci --we-are-go-for-launch  # Actually publish

# Multi-repo workflow
core dev work             # Status + commit + push
core dev work --status    # Just show status

# PHP development
core php dev              # Start dev environment
core php test             # Run tests

Configuration

Core uses .core/ directory for project configuration:

.core/
├── release.yaml    # Release targets and settings
├── build.yaml      # Build configuration (optional)
└── linuxkit/       # LinuxKit templates

And repos.yaml in workspace root for multi-repo management.

Guides

• Getting Started - Installation and first steps
• Workflows - Common task sequences
• Troubleshooting - When things go wrong
• Migration - Moving from legacy tools

Reference

• Configuration - All config options
• Glossary - Term definitions

Claude Code Skill

Install the skill to teach Claude Code how to use the Core CLI:

curl -fsSL https://raw.githubusercontent.com/host-uk/core/main/.claude/skills/core/install.sh | bash

See skill/ for details.