Initial javabin CLI with register, status, and whoami commands

Go CLI using cobra for command framework and AWS SDK v2.

Commands:
- register: interactive wizard, creates registration PR against javaBin/registry
- status: project costs (Cost Explorer), ECS services, deployment info
- whoami: AWS identity (STS), GitHub user (gh CLI)

Auth: GitHub via gh CLI token or GITHUB_TOKEN env var.
AWS via standard credential chain. Cognito deferred to Phase 1.

Includes GoReleaser config for cross-platform builds and Homebrew tap.

Author: Alexanderamiri

.goreleaser.yml

@@ -0,0 +1,38 @@
+version: 2
+
+builds:
+  - main: .
+    binary: javabin
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - darwin
+      - linux
+    goarch:
+      - amd64
+      - arm64
+    ldflags:
+      - -s -w -X main.version={{.Version}} -X main.commit={{.Commit}}
+
+archives:
+  - format: tar.gz
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+
+brews:
+  - repository:
+      owner: javaBin
+      name: homebrew-tap
+    homepage: https://github.com/javaBin/javabin-cli
+    description: Developer CLI for the Javabin platform
+    install: |
+      bin.install "javabin"
+
+checksum:
+  name_template: checksums.txt
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - "^docs:"
+      - "^test:"

README.md

@@ -0,0 +1,58 @@
+# javabin CLI
+
+Developer CLI for the Javabin platform.
+
+## Install
+
+```bash
+brew install javaBin/tap/javabin        # macOS/Linux via Homebrew
+go install github.com/javaBin/javabin-cli@latest  # Go toolchain
+```
+
+## Commands
+
+### `javabin register`
+
+Interactive wizard to register a new app with the platform. Creates a PR against [javaBin/registry](https://github.com/javaBin/registry).
+
+```bash
+javabin register
+```
+
+### `javabin status`
+
+Show project status: costs, ECS services, deployments.
+
+```bash
+javabin status              # infers project from git remote
+javabin status --project moresleep
+```
+
+### `javabin whoami`
+
+Show current identity (AWS + GitHub).
+
+```bash
+javabin whoami
+```
+
+## Authentication
+
+- **GitHub:** Uses `gh auth token` if available, or `GITHUB_TOKEN`/`GH_TOKEN` environment variables
+- **AWS:** Standard credential chain (environment variables, `~/.aws/credentials`, SSO)
+
+## What This CLI Does NOT Do
+
+- No deploy, plan, apply, or generate commands — those run exclusively in CI
+- No infrastructure management — use `app.yaml` and let the platform handle it
+
+## Development
+
+```bash
+go build -o javabin .
+./javabin --help
+```
+
+## Release
+
+Releases are built with [GoReleaser](https://goreleaser.com/) on semver tags. Binaries are published to GitHub Releases and the Homebrew tap.

cmd/register.go

@@ -0,0 +1,167 @@
+package cmd
+
+import (
+	"bufio"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"os"
+	"strings"
+
+	"github.com/javaBin/javabin-cli/internal/config"
+	gh "github.com/javaBin/javabin-cli/internal/github"
+	"github.com/spf13/cobra"
+)
+
+var registerCmd = &cobra.Command{
+	Use:   "register",
+	Short: "Register a new app with the Javabin platform",
+	Long:  "Interactive wizard that creates a registration PR against javaBin/registry.",
+	RunE:  runRegister,
+}
+
+func runRegister(cmd *cobra.Command, args []string) error {
+	reader := bufio.NewReader(os.Stdin)
+	prompt := func(label, defaultVal string) string {
+		if defaultVal != "" {
+			fmt.Printf("%s [%s]: ", label, defaultVal)
+		} else {
+			fmt.Printf("%s: ", label)
+		}
+		input, _ := reader.ReadString('\n')
+		input = strings.TrimSpace(input)
+		if input == "" {
+			return defaultVal
+		}
+		return input
+	}
+
+	token, err := gh.GetToken()
+	if err != nil {
+		return fmt.Errorf("GitHub auth required: %w", err)
+	}
+
+	// Repo name
+	repoName := prompt("Repository name (e.g. moresleep)", "")
+	if repoName == "" {
+		return fmt.Errorf("repository name is required")
+	}
+
+	// Validate repo exists
+	fmt.Printf("Checking javaBin/%s exists... ", repoName)
+	if !repoExists(token, repoName) {
+		fmt.Println("not found")
+		return fmt.Errorf("repository javaBin/%s does not exist", repoName)
+	}
+	fmt.Println("ok")
+
+	// List teams from registry
+	fmt.Println("\nAvailable teams:")
+	teams, err := listTeams(token)
+	if err != nil {
+		fmt.Printf("  (could not fetch teams: %v)\n", err)
+	} else {
+		for _, t := range teams {
+			fmt.Printf("  - %s\n", t)
+		}
+	}
+	team := prompt("\nTeam", "")
+	if team == "" {
+		return fmt.Errorf("team is required")
+	}
+
+	// Auth
+	fmt.Println("\nAuth options: internal, external, both, none")
+	auth := prompt("Auth", "none")
+
+	// Budget
+	budget := prompt("Monthly budget (NOK)", "1000")
+
+	// Dev environment
+	devEnv := prompt("Need a dev environment? (y/n)", "n")
+
+	// Confirm
+	fmt.Println("\n--- Registration Summary ---")
+	fmt.Printf("  Repo:   javaBin/%s\n", repoName)
+	fmt.Printf("  Team:   %s\n", team)
+	fmt.Printf("  Auth:   %s\n", auth)
+	fmt.Printf("  Budget: %s NOK\n", budget)
+	if strings.ToLower(devEnv) == "y" {
+		fmt.Println("  Dev:    yes")
+	}
+	fmt.Println()
+
+	confirm := prompt("Create registration PR? (y/n)", "y")
+	if strings.ToLower(confirm) != "y" {
+		fmt.Println("Cancelled.")
+		return nil
+	}
+
+	// Build app YAML content
+	var yamlLines []string
+	yamlLines = append(yamlLines, fmt.Sprintf("name: %s", repoName))
+	yamlLines = append(yamlLines, fmt.Sprintf("team: %s", team))
+	yamlLines = append(yamlLines, fmt.Sprintf("repo: javaBin/%s", repoName))
+	if auth != "none" && auth != "" {
+		yamlLines = append(yamlLines, fmt.Sprintf("auth: %s", auth))
+	}
+	if budget != "1000" && budget != "" {
+		yamlLines = append(yamlLines, fmt.Sprintf("budget_alert_nok: %s", budget))
+	}
+	yamlContent := strings.Join(yamlLines, "\n") + "\n"
+
+	// Create PR via GitHub API
+	filePath := fmt.Sprintf("apps/%s.yaml", repoName)
+	branchName := fmt.Sprintf("register-%s", repoName)
+	prTitle := fmt.Sprintf("Register %s", repoName)
+	prBody := fmt.Sprintf("Register `javaBin/%s` with team `%s`.\n\nCreated by `javabin register`.", repoName, team)
+
+	prURL, err := gh.CreateRegistrationPR(token, branchName, filePath, yamlContent, prTitle, prBody)
+	if err != nil {
+		return fmt.Errorf("failed to create PR: %w", err)
+	}
+
+	fmt.Printf("\nRegistration PR created: %s\n", prURL)
+	fmt.Println("A platform owner will review and merge it.")
+
+	_ = config.EnsureConfigDir()
+	return nil
+}
+
+func repoExists(token, name string) bool {
+	req, _ := http.NewRequest("GET", fmt.Sprintf("https://api.github.com/repos/javaBin/%s", name), nil)
+	req.Header.Set("Authorization", "Bearer "+token)
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return false
+	}
+	defer resp.Body.Close()
+	return resp.StatusCode == 200
+}
+
+func listTeams(token string) ([]string, error) {
+	url := "https://api.github.com/repos/javaBin/registry/contents/teams"
+	req, _ := http.NewRequest("GET", url, nil)
+	req.Header.Set("Authorization", "Bearer "+token)
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+	if resp.StatusCode != 200 {
+		return nil, fmt.Errorf("HTTP %d", resp.StatusCode)
+	}
+	var items []struct {
+		Name string `json:"name"`
+	}
+	if err := json.NewDecoder(resp.Body).Decode(&items); err != nil {
+		return nil, err
+	}
+	var teams []string
+	for _, item := range items {
+		if strings.HasSuffix(item.Name, ".yaml") {
+			teams = append(teams, strings.TrimSuffix(item.Name, ".yaml"))
+		}
+	}
+	return teams, nil
+}

cmd/root.go

@@ -0,0 +1,21 @@
+package cmd
+
+import (
+	"github.com/spf13/cobra"
+)
+
+var rootCmd = &cobra.Command{
+	Use:   "javabin",
+	Short: "Javabin platform CLI",
+	Long:  "Developer CLI for the Javabin platform. Register apps, check status, and manage identity.",
+}
+
+func Execute() error {
+	return rootCmd.Execute()
+}
+
+func init() {
+	rootCmd.AddCommand(registerCmd)
+	rootCmd.AddCommand(statusCmd)
+	rootCmd.AddCommand(whoamiCmd)
+}

cmd/status.go

@@ -0,0 +1,94 @@
+package cmd
+
+import (
+	"context"
+	"fmt"
+	"os/exec"
+	"strings"
+
+	"github.com/javaBin/javabin-cli/internal/aws"
+	"github.com/javaBin/javabin-cli/internal/config"
+	"github.com/spf13/cobra"
+)
+
+var projectFlag string
+
+var statusCmd = &cobra.Command{
+	Use:   "status",
+	Short: "Show project status (costs, services, deployments)",
+	RunE:  runStatus,
+}
+
+func init() {
+	statusCmd.Flags().StringVar(&projectFlag, "project", "", "Project name (inferred from git remote if not set)")
+}
+
+func runStatus(cmd *cobra.Command, args []string) error {
+	project := projectFlag
+	if project == "" {
+		project = inferProject()
+	}
+	if project == "" {
+		return fmt.Errorf("could not infer project name — use --project flag or run from a javaBin repo")
+	}
+
+	fmt.Printf("Project: %s\n\n", project)
+	ctx := context.Background()
+
+	cfg, err := aws.LoadConfig(ctx)
+	if err != nil {
+		return fmt.Errorf("AWS credentials not configured: %w", err)
+	}
+
+	// Cost this month
+	fmt.Println("--- Costs (month-to-date) ---")
+	cost, err := aws.GetMonthlyCost(ctx, cfg, project)
+	if err != nil {
+		fmt.Printf("  Could not fetch costs: %v\n", err)
+	} else {
+		fmt.Printf("  Spend: $%.2f\n", cost)
+	}
+
+	// ECS services
+	fmt.Println("\n--- ECS Services ---")
+	services, err := aws.ListServices(ctx, cfg, "javabin-platform")
+	if err != nil {
+		fmt.Printf("  Could not list services: %v\n", err)
+	} else if len(services) == 0 {
+		fmt.Println("  No running services")
+	} else {
+		for _, svc := range services {
+			if strings.Contains(svc.Name, project) {
+				fmt.Printf("  %s  running=%d desired=%d\n", svc.Name, svc.RunningCount, svc.DesiredCount)
+			}
+		}
+	}
+
+	// TODO: Last 5 deployments (requires ECS describe-services with deployments)
+	// TODO: Untagged resources (requires Config or resource group tagging API)
+
+	_ = config.EnsureConfigDir()
+	return nil
+}
+
+func inferProject() string {
+	out, err := exec.Command("git", "remote", "get-url", "origin").Output()
+	if err != nil {
+		return ""
+	}
+	url := strings.TrimSpace(string(out))
+	// Handle both HTTPS and SSH URLs
+	// https://github.com/javaBin/moresleep.git -> moresleep
+	// git@github.com:javaBin/moresleep.git -> moresleep
+	for _, prefix := range []string{
+		"https://github.com/javaBin/",
+		"git@github.com:javaBin/",
+	} {
+		if strings.HasPrefix(url, prefix) {
+			name := strings.TrimPrefix(url, prefix)
+			name = strings.TrimSuffix(name, ".git")
+			return name
+		}
+	}
+	return ""
+}