"long":"Manage tasks from the core-agentic service for AI-assisted development.\n\nCommands:\n tasks List tasks (filterable by status, priority, labels)\n task View task details or auto-select highest priority\n task:update Update task status or progress\n task:complete Mark task as completed or failed\n task:commit Create git commit with task reference\n task:pr Create GitHub PR linked to task\n claude Claude Code integration\n\nWorkflow:\n core ai tasks # List pending tasks\n core ai task --auto --claim # Auto-select and claim a task\n core ai task:commit <id> -m 'msg' # Commit with task reference\n core ai task:complete <id> # Mark task done",
"context":"Show gathered context for AI collaboration"
},
"id_required":"task ID required (or use --auto)",
"long":"Shows details of a specific task or auto-selects the highest priority task.\n\nExamples:\n core ai task abc123 # Show task details\n core ai task abc123 --claim # Show and claim the task\n core ai task abc123 --context # Show task with gathered context\n core ai task --auto # Auto-select highest priority pending task",
"scope":"Scope for the commit type (e.g., auth, api, ui)"
},
"long":"Creates a git commit with a task reference and co-author attribution.\n\nCommit message format:\n feat(scope): description\n\n Task: #123\n Co-Authored-By: Claude <noreply@anthropic.com>\n\nExamples:\n core ai task:commit abc123 --message 'add user authentication'\n core ai task:commit abc123 -m 'fix login bug' --scope auth\n core ai task:commit abc123 -m 'update docs' --push",
"message_required":"commit message required (--message or -m)",
"no_changes":"No uncommitted changes to commit.",
"pushed":"Changes pushed successfully",
"pushing":"Pushing changes...",
"short":"Auto-commit changes with task reference"
},
"task_complete":{
"failed":"Task {{.ID}} marked as failed",
"flag":{
"error":"Error message if failed",
"failed":"Mark the task as failed",
"output":"Summary of the completed work"
},
"long":"Marks a task as completed with optional output and artifacts.\n\nExamples:\n core ai task:complete abc123 --output 'Feature implemented'\n core ai task:complete abc123 --failed --error 'Build failed'",
"short":"Mark a task as completed",
"success":"Task {{.ID}} completed successfully"
},
"task_pr":{
"branch_error":"cannot create PR from {{.Branch}} branch; create a feature branch first",
"created":"Pull request created!",
"creating":"Creating pull request...",
"flag":{
"base":"Base branch (defaults to main)",
"draft":"Create as draft PR",
"labels":"Labels to add (comma-separated)",
"title":"PR title (defaults to task title)"
},
"long":"Creates a GitHub pull request linked to a task.\n\nRequires the GitHub CLI (gh) to be installed and authenticated.\n\nExamples:\n core ai task:pr abc123\n core ai task:pr abc123 --title 'Add authentication feature'\n core ai task:pr abc123 --draft --labels 'enhancement,needs-review'\n core ai task:pr abc123 --base develop",
"pushing_branch":"Pushing branch {{.Branch}}...",
"short":"Create a pull request for a task"
},
"task_update":{
"flag":{
"notes":"Notes about the update",
"progress":"Progress percentage (0-100)",
"status":"New status (pending, in_progress, completed, blocked)"
},
"flag_required":"at least one of --status, --progress, or --notes required",
"long":"Updates a task's status, progress, or adds notes.\n\nExamples:\n core ai task:update abc123 --status in_progress\n core ai task:update abc123 --progress 50 --notes 'Halfway done'",
"short":"Update task status or progress",
"success":"Task {{.ID}} updated successfully"
},
"tasks":{
"flag":{
"labels":"Filter by labels (comma-separated)",
"limit":"Max number of tasks to return",
"priority":"Filter by priority (critical, high, medium, low)",
"project":"Filter by project",
"status":"Filter by status (pending, in_progress, completed, blocked)"
},
"found":"{{.Count}} task(s) found:",
"hint":"Use 'core ai task <id>' to view details",
"long":"Lists tasks from the core-agentic service.\n\nConfiguration is loaded from:\n 1. Environment variables (AGENTIC_TOKEN, AGENTIC_BASE_URL)\n 2. .env file in current directory\n 3. ~/.core/agentic.yaml\n\nExamples:\n core ai tasks\n core ai tasks --status pending --priority high\n core ai tasks --labels bug,urgent",
"none_found":"No tasks found.",
"short":"List available tasks from core-agentic"
}
},
"build":{
"building_project":"Building project",
"built_artifacts":"Built {{.Count}} artifact(s)",
"computing_checksums":"Computing checksums...",
"creating_archives":"Creating archives...",
"error":{
"archive_failed":"archive failed",
"checksum_failed":"checksum failed",
"detect_type":"failed to detect project type",
"gpg_signing_failed":"GPG signing failed",
"invalid_target":"invalid target format \"{{.Target}}\", expected OS/arch (e.g., linux/amd64)",
"marshal_artifacts":"failed to marshal artifacts",
"no_project_type":"no supported project type detected in {{.Dir}}\nSupported types: go (go.mod), wails (wails.json), node (package.json), php (composer.json)",
"no_targets":"no valid targets specified",
"node_not_implemented":"Node.js builder not yet implemented",
"notarization_failed":"notarization failed",
"php_not_implemented":"PHP builder not yet implemented",
"signing_failed":"signing failed",
"unsupported_type":"unsupported project type",
"write_checksums":"failed to write CHECKSUMS.txt"
},
"flag":{
"archive":"Create archives (tar.gz for linux/darwin, zip for windows)",
"checksum":"Generate SHA256 checksums and CHECKSUMS.txt",
"ci":"CI mode - minimal output with JSON artifact list at the end",
"config":"Config file path (for linuxkit: YAML config, for docker: Dockerfile)",
"format":"Output format for linuxkit (iso-bios, qcow2-bios, raw, vmdk)",
"image":"Docker image name (e.g., host-uk/core-devops)",
"no_sign":"Skip all code signing",
"notarize":"Enable macOS notarization (requires Apple credentials)",
"output":"Output directory for artifacts (default: dist)",
"long":"Publishes pre-built artifacts from dist/ to configured targets.\nRun 'core build' first to create artifacts.\n\nSAFE BY DEFAULT: Runs in dry-run mode unless --we-are-go-for-launch is specified.\n\nConfiguration: .core/release.yaml",
"publish_completed":"Publish completed!",
"publishing":"Publishing release",
"release":{
"short":"Create a release"
},
"short":"Publish releases (dry-run by default)",
"version":{
"long":"Shows the determined version or validates a version string.",
"long":"Fetches GitHub Actions workflow status for all repos.\nShows latest run status for each repo.\nRequires the 'gh' CLI to be installed and authenticated.",
"no_ci":"{{.Count}} no CI",
"passing":"{{.Count}} passing",
"repos_checked":"{{.Count}} repos checked",
"short":"Check CI status across all repos"
},
"commit":{
"committing":"Committing dirty repos with Claude...",
"long":"Fetches open issues from GitHub for all repos in the registry.\nRequires the 'gh' CLI to be installed and authenticated.",
"no_issues":"No open issues found.",
"open_issues":"{{.Count}} open issue(s):",
"short":"List open issues across all repos"
},
"long":"Manage multiple git repositories and GitHub integration.\n\nUses repos.yaml to discover repositories. Falls back to scanning\nthe current directory if no registry is found.\n\nGit Operations:\n work Combined status -> commit -> push workflow\n health Quick repo health summary\n commit Claude-assisted commit messages\n push Push repos with unpushed commits\n pull Pull repos behind remote\n\nGitHub Integration (requires gh CLI):\n issues List open issues across repos\n reviews List PRs awaiting review\n ci Check GitHub Actions status\n impact Analyse dependency impact\n\nDev Environment:\n install Download dev environment image\n boot Start dev environment VM\n stop Stop dev environment VM\n shell Open shell in dev VM\n status Check dev VM status",
"modified":"{{.Count}} modified",
"no_changes":"No uncommitted changes found.",
"no_git_repos":"No git repositories found.",
"pull":{
"all_up_to_date":"All repos up to date. Nothing to pull.",
"long":"Fetches open PRs from GitHub for all repos in the registry.\nShows review status (approved, changes requested, pending).\nRequires the 'gh' CLI to be installed and authenticated.",
"no_prs":"No open PRs found.",
"open_prs":"{{.Count}} open PR(s)",
"short":"List PRs needing review across all repos",
"long":"This command scans the 'pkg' directory for services and ensures that the\ntop-level public API for each service is in sync with its internal implementation.\nIt automatically generates the necessary Go files with type aliases.",
"short":"Synchronizes public service APIs with internal implementations",
"long":"Starts a Claude Code session inside the dev environment sandbox.\n\nProvides isolation while forwarding selected credentials.\nAuto-boots the dev environment if not running.\n\nAuth options (default: all):\n gh - GitHub CLI auth\n anthropic - Anthropic API key\n ssh - SSH agent forwarding\n git - Git config (name, email)\n\nExamples:\n core dev claude\n core dev claude --model opus\n core dev claude --auth gh,anthropic\n core dev claude --no-auth",
"short":"Start sandboxed Claude session"
},
"config_label":"Config:",
"config_value":"{{.Memory}}MB, {{.CPUs}} CPUs",
"connect_with":"Connect with: {{.Command}}",
"container_label":"Container:",
"cpus_label":"CPUs:",
"downloading":"Downloading dev environment...",
"downloading_update":"Downloading update...",
"install":{
"long":"Downloads the platform-specific dev environment image.\n\nThe image includes Go, PHP, Node.js, Python, Docker, and Claude CLI.\nDownloads are cached at ~/.core/images/\n\nExamples:\n core dev install",
"short":"Download and install the dev environment image"
},
"install_with":"Install with: {{.Command}}",
"installed_in":"Installed in {{.Duration}}",
"installed_label":"Installed:",
"installed_no":"No",
"installed_yes":"Yes",
"latest_label":"Latest:",
"memory_label":"Memory:",
"not_installed":"dev environment not installed (run 'core dev install' first)",
"not_running":"Dev environment is not running",
"progress_label":"Progress:",
"run_to_update":"Run {{.Command}} to update",
"running":"Dev environment running",
"serve":{
"flag":{
"path":"Subdirectory to serve",
"port":"Port to serve on (default: 8000)"
},
"long":"Mounts the current project into the dev environment and starts a dev server.\n\nAuto-detects the appropriate serve command based on project files.\n\nExamples:\n core dev serve\n core dev serve --port 3000\n core dev serve --path public",
"short":"Mount project and start dev server"
},
"shell":{
"flag":{
"console":"Use serial console instead of SSH"
},
"long":"Opens an interactive shell in the dev environment.\n\nUses SSH by default, or serial console with --console.\n\nExamples:\n core dev shell\n core dev shell --console\n core dev shell -- ls -la",
"short":"Connect to the dev environment"
},
"ssh_port":"SSH port:",
"start_with":"Start with: {{.Command}}",
"status":{
"long":"Shows the current status of the dev environment.\n\nExamples:\n core dev vm-status",
"short":"Show dev environment status"
},
"status_title":"Dev Environment Status",
"stop":{
"long":"Stops the running dev environment VM.\n\nExamples:\n core dev stop",
"short":"Stop the dev environment"
},
"stopping":"Stopping dev environment...",
"stopping_current":"Stopping current instance...",
"test":{
"flag":{
"name":"Run named test command from .core/test.yaml"
},
"long":"Runs tests in the dev environment.\n\nAuto-detects the test command based on project files, or uses .core/test.yaml.\n\nExamples:\n core dev test\n core dev test --name integration\n core dev test -- go test -v ./...",
"short":"Run tests in the dev environment"
},
"up_to_date":"Already up to date",
"update":{
"flag":{
"apply":"Download and apply the update"
},
"long":"Checks for dev environment updates and optionally applies them.\n\nExamples:\n core dev update\n core dev update --apply",
"commit":"Use Claude to commit dirty repos before pushing",
"status":"Show status only, don't push"
},
"long":"Manage git status, commits, and pushes across multiple repositories.\n\nReads repos.yaml to discover repositories and their relationships.\nShows status, optionally commits with Claude, and pushes changes.",
"short":"Multi-repo git operations",
"table_ahead":"Ahead",
"table_modified":"Modified",
"table_staged":"Staged",
"table_untracked":"Untracked",
"use_commit_flag":"Use --commit to have Claude create commits"
}
},
"docs":{
"error":{
"load_registry":"failed to load registry",
"scan_directory":"failed to scan directory"
},
"list":{
"coverage_summary":"{{.WithDocs}} with docs, {{.WithoutDocs}} without",
"long":"List documentation files for all repos in the workspace.\n\nShows README.md, CLAUDE.md, CHANGELOG.md, and docs/ directory status\nfor each repository.",
"short":"List documentation across repos"
},
"long":"Manage documentation across all repos.\nScan for docs, check coverage, and sync to core-php/docs/packages/.",
"short":"Documentation management",
"sync":{
"confirm":"Sync?",
"dry_run_notice":"Dry run - no files copied",
"files_count":"({{.Count}} files)",
"flag":{
"dry_run":"Show what would be synced without copying",
"long":"Sync documentation from all repos to a central location.\n\nCopies docs/ directories from each package to core-php/docs/packages/\nfor unified documentation builds.",
"no_docs_found":"No documentation found in any repos.",
"repos_with_docs":"{{.Count}} repo(s) with docs/ directories",
"short":"Sync documentation to core-php/docs/packages/",
"synced_packages":"Synced {{.Count}} packages",
"total_summary":"{{.Files}} files from {{.Repos}} repos → {{.Output}}"
"verbose_flag":"Show detailed version information",
"workspace":"Workspace:"
},
"go":{
"build":{
"short":"Build Go binaries"
},
"cov":{
"below_threshold":"FAIL Coverage {{.Actual}}% is below threshold {{.Threshold}}%",
"error":{
"below_threshold":"coverage below threshold",
"create_file":"failed to create coverage file",
"discover":"failed to discover test packages",
"generate_html":"failed to generate HTML",
"get_coverage":"failed to get coverage",
"no_packages":"no test packages found"
},
"flag":{
"html":"Generate HTML coverage report",
"open":"Generate and open HTML report in browser",
"threshold":"Minimum coverage percentage (exit 1 if below)"
},
"html_label":"HTML:",
"long":"Run tests and generate coverage report.\n\nExamples:\n core go cov # Run with coverage summary\n core go cov --html # Generate HTML report\n core go cov --open # Generate and open HTML report\n core go cov --threshold 80 # Fail if coverage < 80%",
"open_manually":"(open manually)",
"running":"Running tests with coverage",
"short":"Run tests with coverage report"
},
"fmt":{
"flag":{
"check":"Check only, exit 1 if not formatted",
"fix":"Fix formatting in place"
},
"long":"Format Go code using gofmt or goimports.\n\nExamples:\n core go fmt # Check formatting\n core go fmt --fix # Fix formatting\n core go fmt --diff # Show diff",
"long":"Install Go binary to $GOPATH/bin.\n\nExamples:\n core go install # Install current module\n core go install ./cmd/core # Install specific path\n core go install --no-cgo # Pure Go (no C dependencies)\n core go install -v # Verbose output",
"short":"Install Go binary",
"success":"OK"
},
"lint":{
"flag":{
"fix":"Fix issues automatically"
},
"long":"Run golangci-lint on the codebase.\n\nExamples:\n core go lint\n core go lint --fix",
"short":"Run golangci-lint"
},
"long":"Go development tools with enhanced output and environment setup.\n\nCommands:\n test Run tests\n cov Run tests with coverage report\n fmt Format Go code\n lint Run golangci-lint\n install Install Go binary\n mod Module management (tidy, download, verify)\n work Workspace management",
"mod":{
"download":{
"short":"Download modules"
},
"graph":{
"short":"Print dependency graph"
},
"long":"Go module management commands.\n\nCommands:\n tidy Add missing and remove unused modules\n download Download modules to local cache\n verify Verify dependencies\n graph Print module dependency graph",
"long":"Run Go tests with coverage reporting.\n\nSets MACOSX_DEPLOYMENT_TARGET=26.0 to suppress linker warnings.\nFilters noisy output and provides colour-coded coverage.\n\nExamples:\n core go test\n core go test --coverage\n core go test --pkg ./pkg/crypt\n core go test --run TestHash",
"template":"LinuxKit template name (default: server-php)",
"type":"Build type: docker (default) or linuxkit"
},
"format":"Format:",
"frontend":"Frontend:",
"laravel":"Laravel:",
"linuxkit_success":"LinuxKit image built successfully",
"long":"Build a production-ready container image for the PHP project.\n\nBy default, builds a Docker image using FrankenPHP.\nUse --type linuxkit to build a LinuxKit VM image instead.",
"force":"Force deployment even if no changes detected",
"staging":"Deploy to staging environment",
"wait":"Wait for deployment to complete"
},
"long":"Deploy the PHP application to Coolify.\n\nRequires configuration in .env:\n COOLIFY_URL=https://coolify.example.com\n COOLIFY_TOKEN=your-api-token\n COOLIFY_APP_ID=production-app-id\n COOLIFY_STAGING_APP_ID=staging-app-id (optional)",
"short":"Deploy to Coolify",
"success":"Deployment completed successfully",
"triggered":"Deployment triggered. Use 'core php deploy:status' to check progress.",
"warning_status":"Deployment ended with status: {{.Status}}"
},
"deploy_list":{
"flag":{
"limit":"Number of deployments to list (default: 10)",
"staging":"List staging deployments"
},
"long":"List recent deployments.",
"none_found":"No deployments found",
"recent":"Recent {{.Environment}} deployments:",
"short":"List recent deployments"
},
"deploy_rollback":{
"flag":{
"id":"Specific deployment ID to rollback to",
"staging":"Rollback staging environment",
"wait":"Wait for rollback to complete"
},
"long":"Rollback to a previous deployment.\n\nIf no deployment ID is specified, rolls back to the most recent\nsuccessful deployment.",
"rolling_back":"Rolling back {{.Environment}}...",
"short":"Rollback to previous deployment",
"success":"Rollback completed successfully",
"triggered":"Rollback triggered. Use 'core php deploy:status' to check progress.",
"warning_status":"Rollback ended with status: {{.Status}}"
"long":"Run Infection mutation testing to measure test suite quality.\n\nMutation testing modifies your code and checks if tests catch\nthe changes. High mutation score = high quality tests.\n\nWarning: This can be slow on large codebases.",
"long":"Stream logs from Laravel services.\n\nServices: frankenphp, vite, horizon, reverb, redis",
"short":"View service logs"
},
"long":"Manage Laravel development environment with FrankenPHP.\n\nServices orchestrated:\n - FrankenPHP/Octane (port 8000, HTTPS on 443)\n - Vite dev server (port 5173)\n - Laravel Horizon (queue workers)\n - Laravel Reverb (WebSocket, port 8080)\n - Redis (port 6379)",
"packages":{
"link":{
"done":"Packages linked. Run 'composer update' to install.",
"linking":"Linking packages...",
"long":"Link local PHP packages for development.\n\nAdds path repositories to composer.json with symlink enabled.\nThe package name is auto-detected from each path's composer.json.",
"short":"Link local packages"
},
"list":{
"linked":"Linked packages:",
"long":"List all locally linked packages.\n\nShows package name, path, and version for each linked package.",
"long":"Link and manage local PHP packages for development.\n\nSimilar to npm link, this adds path repositories to composer.json\nfor developing packages alongside your project.",
"short":"Manage local PHP packages",
"unlink":{
"done":"Packages unlinked. Run 'composer update' to remove.",
"long":"Remove linked packages from composer.json.\n\nRemoves path repositories by package name.",
"short":"Unlink packages",
"unlinking":"Unlinking packages..."
},
"update":{
"done":"Packages updated",
"long":"Run composer update for linked packages.\n\nIf no packages specified, updates all packages.",
"short":"Update linked packages",
"updating":"Updating packages..."
}
},
"psalm":{
"analysing":"Analysing code with Psalm",
"analysing_fixing":"Analysing and fixing code with Psalm",
"long":"Run Psalm deep static analysis with Laravel plugin support.\n\nPsalm provides deeper type inference than PHPStan and catches\ndifferent classes of bugs. Both should be run for best coverage.",
"long":"Manage host-uk/core-* packages and repositories.\n\nCommands:\n search Search GitHub for packages\n install Clone a package from GitHub\n list List installed packages\n update Update installed packages\n outdated Check for outdated packages",
"no_description":"(no description)",
"outdated":{
"all_up_to_date":"All packages up to date",
"commits_behind":"{{.Count}} commits behind",
"long":"Checks which packages have unpulled commits.\n\nExamples:\n core pkg outdated",
"outdated_label":"Outdated:",
"short":"Check for outdated packages",
"summary":"{{.Outdated}} outdated, {{.UpToDate}} up to date",
"update_with":"Update with:"
},
"search":{
"cache_label":"Cache:",
"fetching_label":"Fetching:",
"flag":{
"limit":"Max results (default 50)",
"org":"GitHub organization (default: host-uk)",
"pattern":"Repo name pattern (* for wildcard)",
"refresh":"Bypass cache and fetch fresh data",
"type":"Filter by type in name (mod, services, plug, website)"
},
"found_repos":"Found {{.Count}} repositories:",
"gh_token_unset":"Unset it with: unset GH_TOKEN",
"gh_token_warning":"GH_TOKEN env var is set - this may cause auth issues",
"long":"Searches GitHub for repositories matching a pattern.\nUses gh CLI for authenticated search. Results are cached for 1 hour.\n\nExamples:\n core pkg search # List all host-uk repos\n core pkg search --pattern 'core-*' # Search for core-* repos\n core pkg search --org mycompany # Search different org\n core pkg search --refresh # Bypass cache",
"no_repos_found":"No repositories found matching pattern.",
"private_label":"[private]",
"short":"Search GitHub for packages"
},
"short":"Package management for core-* repos",
"update":{
"flag":{
"all":"Update all packages"
},
"long":"Pulls latest changes for installed packages.\n\nExamples:\n core pkg update core-php # Update specific package\n core pkg update --all # Update all packages",
"base_required":"--base is required (version tag or file path)"
},
"flag":{
"base":"Base spec (version tag or file)",
"spec":"Current spec file"
},
"label":"SDK Diff:",
"long":"Check for breaking API changes between spec versions.\n\nCompares a base spec (version tag or file) against the current spec\nand reports any breaking changes that would affect API consumers.",
"short":"Check for breaking API changes"
},
"label":{
"ok":"OK:",
"sdk":"SDK:"
},
"long":"Tools for validating OpenAPI specs and checking API compatibility.\nTo generate SDKs, use: core build sdk\n\nCommands:\n diff Check for breaking API changes\n validate Validate OpenAPI spec syntax",
"short":"SDK validation and API compatibility tools",
"validate":{
"long":"Validate OpenAPI spec syntax.\n\nChecks that the OpenAPI specification file is valid and well-formed.",
"short":"Validate OpenAPI spec",
"valid":"Spec is valid",
"validating":"Validating OpenAPI spec"
}
},
"setup":{
"already_exist_count":"{{.Count}} already exist",
"already_exists":"already exists",
"bootstrap_mode":"Bootstrap mode (no repos.yaml found)",
"cancelled":"Cancelled.",
"cloned":"cloned",
"cloned_count":"{{.Count}} cloned",
"cloning_current_dir":"Cloning into current directory",
"all":"Skip wizard, clone all packages (non-interactive)",
"build":"Run build after cloning",
"dry_run":"Show what would be cloned without cloning",
"name":"Project directory name for bootstrap mode",
"only":"Only clone repos of these types (comma-separated: foundation,module,product)",
"registry":"Path to repos.yaml (auto-detected if not specified)"
},
"long":"Sets up a development workspace.\n\nREGISTRY MODE (repos.yaml exists):\n Clones all repositories defined in repos.yaml into packages/.\n Skips repos that already exist. Use --only to filter by type.\n\nBOOTSTRAP MODE (no repos.yaml):\n 1. Clones core-devops to set up the workspace\n 2. Presents an interactive wizard to select packages\n 3. Clones selected packages\n\nUse --all to skip the wizard and clone everything.",
"nothing_to_clone":"Nothing to clone.",
"org_label":"Org:",
"repo":{
"created":"Created",
"detected_type":"Detected project type",
"setting_up":"Setting up repository",
"would_create":"Would create"
},
"running_build":"Running build...",
"short":"Bootstrap workspace or clone packages from registry",
"to_clone":"{{.Count}} to clone",
"wizard":{
"confirm_cancel":"Cancel",
"confirm_clone":"Clone {{.Count}} packages to {{.Target}}?",
"confirm_yes":"Yes, clone",
"git_repo_title":"This directory is a git repository",
"option_package":"Create Package (clone repos into subdirectory)",
"option_setup":"Setup Working Directory",
"package_selection":"Package Selection",
"project_name_desc":"Enter the name for your new workspace directory",
"project_name_title":"Project directory name",
"select_packages":"Select packages to clone",
"selection_hint":"Use space to select/deselect, enter to confirm",
"long":"Runs Go tests with coverage reporting.\n\nSets MACOSX_DEPLOYMENT_TARGET=26.0 to suppress linker warnings on macOS.\n\nExamples:\n core test # Run all tests with coverage summary\n core test --verbose # Show test output as it runs\n core test --coverage # Show detailed per-package coverage\n core test --pkg ./pkg/... # Test specific packages\n core test --run TestName # Run specific test by name\n core test --short # Skip long-running tests\n core test --race # Enable race detector\n core test --json # Output JSON for CI/agents",
"tests_failed":"Tests failed"
},
"vm":{
"error":{
"apply_template":"failed to apply template",
"build_image":"failed to build image",
"create_temp":"failed to create temp directory",
"id_and_cmd_required":"container ID and command are required",
"id_required":"container ID is required",
"init_manager":"failed to initialize container manager",
"linuxkit_not_found":"linuxkit not found. Install with: brew install linuxkit (macOS) or see https://github.com/linuxkit/linuxkit",
"list_containers":"failed to list containers",
"multiple_match":"multiple containers match '{{.ID}}', be more specific",
"no_image_found":"no image found after build",
"no_match":"no container found matching: {{.ID}}",
"run_container":"failed to run container",
"stop_container":"failed to stop container",
"template_required":"template name is required",
"write_template":"failed to write template"
},
"exec":{
"long":"Execute a command inside a running VM via SSH.\n\nExamples:\n core vm exec abc12345 ls -la\n core vm exec abc1 /bin/sh",
"short":"Execute a command in a VM"
},
"hint":{
"stop":"Use 'core vm stop {{.ID}}' to stop",
"view_logs":"Use 'core vm logs {{.ID}}' to view output"
"long":"View logs from a VM.\n\nExamples:\n core vm logs abc12345\n core vm logs -f abc1",
"short":"View VM logs"
},
"long":"Manage LinuxKit virtual machines.\n\nLinuxKit VMs are lightweight, immutable VMs built from YAML templates.\nThey run using qemu or hyperkit depending on your system.\n\nCommands:\n run Run a VM from image or template\n ps List running VMs\n stop Stop a running VM\n logs View VM logs\n exec Execute command in VM\n templates Manage LinuxKit templates",
"ps":{
"flag":{
"all":"Show all containers (including stopped)"
},
"header":"ID\tNAME\tIMAGE\tSTATUS\tSTARTED\tPID",
"long":"Lists all VMs. By default, only shows running VMs.\n\nExamples:\n core vm ps\n core vm ps -a",
"no_containers":"No containers",
"no_running":"No running containers",
"short":"List running VMs"
},
"run":{
"error":{
"image_required":"image path is required (or use --template)"
},
"flag":{
"cpus":"Number of CPUs (default: 1)",
"detach":"Run in detached mode (background)",
"memory":"Memory in MB (default: 1024)",
"name":"Name for the container",
"ssh_port":"SSH port for exec commands (default: 2222)",
"template":"Run from a LinuxKit template (build + run)",
"var":"Template variable in KEY=VALUE format (can be repeated)"
},
"long":"Runs a LinuxKit image as a VM using the available hypervisor.\n\nSupported image formats: .iso, .qcow2, .vmdk, .raw\n\nYou can also run from a template using --template, which will build and run\nthe image automatically. Use --var to set template variables.\n\nExamples:\n core vm run image.iso\n core vm run -d image.qcow2\n core vm run --name myvm --memory 2048 --cpus 4 image.iso\n core vm run --template core-dev --var SSH_KEY=\"ssh-rsa AAAA...\"\n core vm run --template server-php --var SSH_KEY=\"...\" --var DOMAIN=example.com",
"short":"Run a LinuxKit image or template"
},
"short":"LinuxKit VM management",
"stop":{
"long":"Stops a running VM by ID.\n\nExamples:\n core vm stop abc12345\n core vm stop abc1",
"short":"Stop a running VM",
"stopping":"Stopping:"
},
"templates":{
"header":"NAME\tDESCRIPTION",
"hint":{
"run":"Run from template:",
"show":"Show template:",
"vars":"Show variables:"
},
"long":"Manage LinuxKit YAML templates for building VMs.\n\nTemplates provide pre-configured LinuxKit configurations for common use cases.\nThey support variable substitution with ${VAR} and ${VAR:-default} syntax.\n\nExamples:\n core vm templates # List available templates\n core vm templates show core-dev # Show template content\n core vm templates vars server-php # Show template variables",
"no_templates":"No templates available.",
"short":"Manage LinuxKit templates",
"show":{
"long":"Display the content of a LinuxKit template.\n\nExamples:\n core templates show core-dev\n core templates show server-php",
"short":"Display template content"
},
"title":"Available LinuxKit Templates",
"vars":{
"long":"Display all variables used in a template.\n\nShows required variables (no default) and optional variables (with defaults).\n\nExamples:\n core templates vars core-dev\n core templates vars server-php",
