mcdeploy/CLAUDE.md

CLAUDE.md

Project Overview

mcdeploy is the Metacircular deployment CLI tool. It builds, pushes, and deploys container images to nodes, manages TLS certificates via Metacrypt, and checks container status.

Build Commands

go build .        # build the binary
go vet ./...      # vet

Architecture

• Single binary — all code in package main
• Config — TOML-based (mcdeploy.toml), defines services, images, nodes, and containers
• Commands — build, push, deploy, cert renew, status
• Exec model — shells out to podman, ssh, scp, and git for all operations
• No auth — relies on SSH keys and existing podman/registry auth
• Module path: git.wntrmute.dev/mc/mcdeploy
• Dependencies: cobra (CLI), go-toml/v2 (config)