forge

forge

A Cobra-based CLI built with Forge.

Quick start

# Install dependencies
task deps

# Build the binary into ./bin/forge
task build

# Run from source
go run ./cmd/forge version

# Or install onto $PATH
task install
forge version

Adding a subcommand

Each subcommand lives in its own file under cmd/forge/. The pattern mirrors version.go:

// cmd/forge/hello.go
package main

import (
	"fmt"

	"github.com/spf13/cobra"
)

var helloCmd = &cobra.Command{
	Use:   "hello [name]",
	Short: "Print a greeting",
	Args:  cobra.MaximumNArgs(1),
	Run: func(cmd *cobra.Command, args []string) {
		name := "world"
		if len(args) > 0 {
			name = args[0]
		}
		fmt.Printf("hello, %s\n", name)
	},
}

func init() {
	rootCmd.AddCommand(helloCmd)
}

For larger commands, factor logic into internal/<package>/ and call it from the cobra Run function. forge add package <name> scaffolds an internal package with a contract interface and tests.

Task commands

Run task --list (or just task) for the full set.

Project structure

forge/
├── cmd/forge/    # Cobra root + subcommands (each in its own file)
├── internal/         # Application packages (forge add package <name>)
├── pkg/config/       # Configuration types (extend as needed)
├── .reliant/         # Forge conventions, skills, project metadata
├── docs/adr/         # Architecture Decision Records
├── forge.yaml        # Forge project manifest (kind: cli)
├── go.mod
├── README.md
└── Taskfile.yml

Build flags

Stamp the binary's version, commit, and date at build time so forge version reports a real release rather than dev:

go build -trimpath -buildvcs=true \
  -ldflags="-X main.version=v1.0.0 -X main.commit=$(git rev-parse HEAD) -X main.date=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  -o bin/forge ./cmd/forge