Kora CLI: Roadmap & Implementation

gh repo create kora --public --license apache-2.0 --description "One CLI. Every API." --clone

cd kora

gh repo view --json name,description,licenseInfo

go mod init github.com/EvanusModestus/kora

cat go.mod

go get github.com/spf13/cobra@latest

go get github.com/spf13/viper@latest

go get github.com/charmbracelet/lipgloss@latest

go get github.com/charmbracelet/bubbletea@latest

go get github.com/go-resty/resty/v2@latest

go get github.com/zalando/go-keyring@latest

go get filippo.io/age@latest

go mod tidy

cat go.sum | wc -l

mkdir -p cmd

mkdir -p internal/client

mkdir -p internal/auth

mkdir -p internal/output

mkdir -p internal/config

mkdir -p pkg/kora

find . -type d | grep -v '.git' | sort

kora/
+-- cmd/
|   +-- root.go          # Root command with ? discovery
+-- internal/
|   +-- client/
|   |   +-- http.go      # HTTP client with retry, TLS, auth
|   +-- auth/
|   |   +-- provider.go  # Auth provider interface
|   +-- output/
|   |   +-- formatter.go # Table, JSON, CSV formatters
|   +-- config/
|       +-- config.go    # Viper config management
+-- pkg/
|   +-- kora/
|       +-- types.go     # Public types
+-- main.go              # Entry point
+-- go.mod
+-- go.sum
+-- Makefile
+-- .goreleaser.yml
+-- .gitignore
+-- LICENSE
+-- README.md

package main

import (
	"os"

	"github.com/EvanusModestus/kora/cmd"
)

func main() {
	if err := cmd.Execute(); err != nil {
		os.Exit(1)
	}
}

package cmd

import (
	"fmt"
	"os"

	"github.com/spf13/cobra"
	"github.com/spf13/viper"
)

// Version is set at build time via ldflags
var Version = "dev"

var rootCmd = &cobra.Command{
	Use:   "kora",
	Short: "One CLI. Every API.",
	Long: `Kora — Universal API CLI

One tool to authenticate, discover, query, and format responses
from any API. Named after the West African 21-stringed instrument:
one instrument, many strings, one musician makes them all sing.

Use '?' after any command to discover available subcommands:
  kora ?              List all vendors
  kora ise ?          List ISE resources
  kora ise endpoints? List endpoint actions`,
	Version: Version,
	PersistentPreRun: func(cmd *cobra.Command, args []string) {
		// Check for ? as last argument for discovery mode
		if len(args) > 0 && args[len(args)-1] == "?" {
			cmd.Help()
			os.Exit(0)
		}
	},
	Run: func(cmd *cobra.Command, args []string) {
		if len(args) == 0 {
			cmd.Help()
		}
	},
}

func Execute() error {
	return rootCmd.Execute()
}

func init() {
	cobra.OnInitialize(initConfig)

	rootCmd.PersistentFlags().String("format", "table", "Output format: table, json, csv, yaml")
	rootCmd.PersistentFlags().Bool("insecure", false, "Skip TLS verification (use with caution)")
	rootCmd.PersistentFlags().Bool("debug", false, "Enable debug output")

	viper.BindPFlag("format", rootCmd.PersistentFlags().Lookup("format"))
	viper.BindPFlag("insecure", rootCmd.PersistentFlags().Lookup("insecure"))
	viper.BindPFlag("debug", rootCmd.PersistentFlags().Lookup("debug"))
}

func initConfig() {
	viper.SetConfigName(".kora")
	viper.SetConfigType("yaml")
	viper.AddConfigPath("$HOME")
	viper.AddConfigPath(".")

	viper.SetEnvPrefix("KORA")
	viper.AutomaticEnv()

	if err := viper.ReadInConfig(); err == nil {
		if viper.GetBool("debug") {
			fmt.Fprintln(os.Stderr, "Using config:", viper.ConfigFileUsed())
		}
	}
}

go build -o kora .

./kora --help

Kora — Universal API CLI

One tool to authenticate, discover, query, and format responses
from any API. Named after the West African 21-stringed instrument:
one instrument, many strings, one musician makes them all sing.

Use '?' after any command to discover available subcommands:
  kora ?              List all vendors
  kora ise ?          List ISE resources
  kora ise endpoints? List endpoint actions

Usage:
  kora [flags]

Flags:
      --debug      Enable debug output
      --format     Output format: table, json, csv, yaml (default "table")
  -h, --help       help for kora
      --insecure   Skip TLS verification (use with caution)
  -v, --version    version for kora

./kora --version

go build -ldflags "-X github.com/EvanusModestus/kora/cmd.Version=0.1.0" -o kora .

./kora --version

go install .

which kora

kora --version

go build -o kora . && sudo mv kora /usr/local/bin/