v0.1.0 — initial public release

Author: rishabyd

.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.26"
+
+      - run: go build -o cb ./cmd/cb
+
+      - run: go vet ./...

.github/workflows/release.yml

@@ -0,0 +1,65 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.26"
+
+      - name: Get version
+        id: version
+        run: |
+          if [ "${{ github.ref_type }}" = "tag" ]; then
+            TAG="${{ github.ref_name }}"
+          else
+            TAG="dev-build"
+          fi
+          VERSION=$(printf '%s' "$TAG" | sed 's/^v//')
+          echo "tag=$TAG" >> $GITHUB_OUTPUT
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Build assets
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          mkdir -p dist
+
+          for target in linux/amd64 linux/arm64; do
+            GOOS="${target%/*}"
+            GOARCH="${target#*/}"
+            TARGET="${GOOS}_${GOARCH}"
+            BIN_DIR="dist/${TARGET}"
+            ASSET="cb_${VERSION}_${TARGET}.tar.gz"
+
+            mkdir -p "$BIN_DIR"
+            CGO_ENABLED=0 GOOS="$GOOS" GOARCH="$GOARCH" \
+              go build -trimpath -ldflags "-s -w -X main.version=${VERSION}" \
+              -o "${BIN_DIR}/cb" ./cmd/cb
+            tar -czf "$ASSET" -C "$BIN_DIR" cb
+
+            echo "Built $ASSET ($(wc -c < "$ASSET") bytes)"
+          done
+
+      - name: Create release and upload assets
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ steps.version.outputs.tag }}
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          gh release create "$TAG" \
+            --title "$TAG" \
+            --notes "Release $TAG" \
+            --target "$GITHUB_SHA" \
+            ./cb_*.tar.gz

.gitignore

@@ -0,0 +1,23 @@
+# Binary
+/cb
+/cmd/cb/cb
+
+# Build
+/dist/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test coverage
+*.out
+coverage.html
+
+# Dependencies (if vendored)
+/vendor/

README.md

@@ -0,0 +1,145 @@
+# cb (Codeberg CLI)
+
+`cb` is a minimal, `gh`-style CLI for Codeberg focused on practical daily workflows.
+
+Current scope:
+- auth login/logout/status
+- repo list/create/migrate
+- self update
+
+## Install / Update / Uninstall
+
+Install:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/rishabyd/codeberg-cli/main/install.sh | sh
+```
+
+Update:
+
+```bash
+cb update
+```
+
+Uninstall:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/rishabyd/codeberg-cli/main/uninstall.sh | sh
+```
+
+From local checkout:
+
+```bash
+./install.sh
+./uninstall.sh
+```
+
+## Command Syntax
+
+```bash
+cb auth <action>
+cb repo <action> [target]
+cb update
+```
+
+Auth:
+
+```bash
+cb auth login
+cb auth status
+cb auth logout
+```
+
+Repo:
+
+```bash
+cb repo list [--limit <n>]
+cb repo create <name> [flags]
+cb repo migrate <owner/repo> [--clone]
+```
+
+Create flags:
+- `-d, --description <text>`
+- `--public`
+- `--private`
+- `--add-readme`
+- `-c, --clone`
+
+## Common Workflows
+
+Create repository:
+
+```bash
+cb repo create my-project --public
+cb repo create my-project --private --description "internal tools"
+cb repo create my-project --public --add-readme --clone
+```
+
+Migrate repository:
+
+```bash
+cb repo migrate owner/repo
+cb repo migrate owner/repo --clone
+```
+
+`cb repo migrate` performs public GitHub -> public Codeberg migration and includes:
+- source code
+- issues
+- pull requests
+- wiki
+- labels
+- milestones
+- releases
+
+## Troubleshooting
+
+- DNS failure (`lookup codeberg.org ... server misbehaving`) is a local network resolver issue, not token expiry.
+- If refresh token is revoked or expired, run `cb auth login` again.
+- Verify auth and API reachability with `cb auth status`.
+- Ensure git HTTPS helper is configured: `git config --global --get credential.https://codeberg.org.helper`.
+
+## Exit Codes
+
+- `0`: success
+- `1`: runtime/auth/network/api error
+- `2`: usage or argument error
+
+## Build from Source
+
+```bash
+go build -o cb ./cmd/cb
+./cb --help
+```
+
+## Platform Compatibility
+
+Official prebuilt release binaries are provided for:
+- Linux x86_64 (`linux_amd64`)
+- Linux ARM64 (`linux_arm64`)
+
+Other platforms can use source build (`go build -o cb ./cmd/cb`).
+
+## Versioning
+
+This project uses Go-native tag-based versioning.
+
+- Local/dev builds show version `dev`.
+- Release builds inject version from git tag using Go linker flags.
+
+Create and publish a release:
+
+```bash
+git status
+git tag -a v0.4.13 -m "v0.4.13"
+git push origin main --tags
+```
+
+To verify locally:
+
+```bash
+go build -ldflags "-X main.version=0.4.13" -o cb ./cmd/cb
+./cb --version
+```
+
+Required secret for releases:
+- `GITHUB_TOKEN` (provided automatically by GitHub Actions)

cmd/cb/main.go

@@ -0,0 +1,29 @@
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/rishabyd/codeberg-cli/internal/commands"
+)
+
+var version = "0.1.0"
+
+func main() {
+	exitCode, err := run()
+	if err != nil {
+		fmt.Fprintln(os.Stderr, err)
+		os.Exit(exitCode)
+	}
+}
+
+func run() (int, error) {
+	err := commands.Execute(version, os.Args[1:])
+	if err != nil {
+		if commands.IsUsageError(err) {
+			return 2, err
+		}
+		return 1, err
+	}
+	return 0, nil
+}

go.mod

@@ -0,0 +1,10 @@
+module github.com/rishabyd/codeberg-cli
+
+go 1.26
+
+require github.com/spf13/cobra v1.10.2
+
+require (
+	github.com/inconshreveable/mousetrap v1.1.0 // indirect
+	github.com/spf13/pflag v1.0.9 // indirect
+)

go.sum

@@ -0,0 +1,10 @@
+github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
+github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
+github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
+github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
+github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU=
+github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4=
+github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
+github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=

install.sh

@@ -0,0 +1,79 @@
+#!/bin/sh
+set -eu
+
+REPO="rishabyd/codeberg-cli"
+INSTALL_DIR="/usr/local/bin"
+BINARY_NAME="cb"
+
+detect_os() {
+  case "$(uname -s)" in
+    Linux*) echo "linux" ;;
+    *) echo "Unsupported operating system" >&2; exit 1 ;;
+  esac
+}
+
+detect_arch() {
+  case "$(uname -m)" in
+    x86_64|amd64) echo "amd64" ;;
+    aarch64|arm64) echo "arm64" ;;
+    *) echo "Unsupported architecture" >&2; exit 1 ;;
+  esac
+}
+
+require_cmd() {
+  command -v "$1" >/dev/null 2>&1 || { echo "Missing required command: $1" >&2; exit 1; }
+}
+
+fetch_latest_tag() {
+  url="https://api.github.com/repos/${REPO}/releases/latest"
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL "$url" | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -n1
+    return
+  fi
+  if command -v wget >/dev/null 2>&1; then
+    wget -qO- "$url" | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -n1
+    return
+  fi
+  echo "Need curl or wget" >&2
+  exit 1
+}
+
+main() {
+  require_cmd tar
+  os=$(detect_os)
+  arch=$(detect_arch)
+  tag=$(fetch_latest_tag)
+  [ -n "$tag" ] || { echo "Could not resolve latest release" >&2; exit 1; }
+
+  version=$(printf "%s" "$tag" | sed 's/^v//')
+  asset="${BINARY_NAME}_${version}_${os}_${arch}.tar.gz"
+  url="https://github.com/${REPO}/releases/download/${tag}/${asset}"
+
+  tmp_dir=$(mktemp -d)
+  trap 'rm -rf "$tmp_dir"' EXIT
+  archive_path="${tmp_dir}/${asset}"
+
+  echo "Downloading ${asset}..."
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL "$url" -o "$archive_path"
+  else
+    wget -qO "$archive_path" "$url"
+  fi
+
+  tar -xzf "$archive_path" -C "$tmp_dir"
+  chmod +x "${tmp_dir}/${BINARY_NAME}"
+
+  target="${INSTALL_DIR}/${BINARY_NAME}"
+  if [ -w "$INSTALL_DIR" ]; then
+    mv "${tmp_dir}/${BINARY_NAME}" "$target"
+  else
+    echo "Installing to ${target} (sudo may prompt)..."
+    sudo mv "${tmp_dir}/${BINARY_NAME}" "$target"
+  fi
+
+  echo "Installed ${BINARY_NAME} ${tag} to ${target}"
+
+  echo "Run: cb auth login"
+}
+
+main