Init

Author: arjunkomath

.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - run: go build ./...
+
+      - run: go test ./...

.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - uses: goreleaser/goreleaser-action@v6
+        with:
+          version: "~> v2"
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}

.gitignore

@@ -0,0 +1,2 @@
+push
+dist/

.goreleaser.yaml

@@ -0,0 +1,58 @@
+version: 2
+
+project_name: push
+
+before:
+  hooks:
+    - go mod tidy
+
+builds:
+  - main: .
+    binary: push
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - darwin
+    goarch:
+      - amd64
+      - arm64
+    ldflags:
+      - -s -w
+      - -X github.com/techulus/push-cli/cmd.Version={{.Version}}
+      - -X github.com/techulus/push-cli/cmd.Commit={{.Commit}}
+      - -X github.com/techulus/push-cli/cmd.BuildDate={{.Date}}
+
+archives:
+  - format: tar.gz
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+
+checksum:
+  name_template: "checksums.txt"
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - "^docs:"
+      - "^test:"
+      - "^chore:"
+
+brews:
+  - repository:
+      owner: techulus
+      name: homebrew-tap
+      token: "{{ .Env.HOMEBREW_TAP_TOKEN }}"
+    directory: Formula
+    homepage: https://push.techulus.com
+    description: CLI for sending push notifications via Push by Techulus
+    license: MIT
+    install: |
+      bin.install "push"
+    test: |
+      system "#{bin}/push", "--version"
+
+release:
+  github:
+    owner: techulus
+    name: push-cli

.mise.toml

@@ -0,0 +1,2 @@
+[tools]
+go = "latest"

README.md

@@ -0,0 +1,94 @@
+# Push CLI
+
+A command-line tool for sending push notifications via [Push by Techulus](https://push.techulus.com).
+
+## Install
+
+### Homebrew
+
+```bash
+brew install techulus/tap/push
+```
+
+### From source
+
+```bash
+go install github.com/techulus/push-cli@latest
+```
+
+### Binary releases
+
+Download pre-built binaries from [GitHub Releases](https://github.com/techulus/push-cli/releases).
+
+## Setup
+
+Get your API key from [Push by Techulus](https://push.techulus.com) and configure the CLI:
+
+```bash
+push config set-key <your-api-key>
+```
+
+Verify your configuration:
+
+```bash
+push config show
+```
+
+## Usage
+
+### Send a notification
+
+```bash
+push notify --title "Deploy Complete" --body "Production v2.1.0 is live"
+```
+
+### With optional flags
+
+```bash
+push notify \
+  --title "Alert" \
+  --body "CPU usage above 90%" \
+  --sound default \
+  --channel monitoring \
+  --link "https://grafana.example.com/dashboard" \
+  --image "https://example.com/chart.png" \
+  --time-sensitive
+```
+
+### Pipe body from stdin
+
+```bash
+echo "Build failed on main" | push notify --title "CI Alert"
+```
+
+```bash
+cat error.log | push notify --title "Error Log"
+```
+
+```bash
+push notify --title "Disk Usage" --body - <<< "$(df -h /)"
+```
+
+### Send async
+
+```bash
+push notify-async --title "Queued" --body "This is processed asynchronously"
+```
+
+### Send to a group
+
+```bash
+push notify-group my-team --title "Standup" --body "Daily standup in 5 minutes"
+```
+
+### Available sounds
+
+`default`, `arcade`, `correct`, `fail`, `harp`, `reveal`, `bubble`, `doorbell`, `flute`, `money`, `scifi`, `clear`, `elevator`, `guitar`, `pop`
+
+## Configuration
+
+The API key is stored in `~/.push/config.yaml`.
+
+## License
+
+MIT

cmd/config.go

@@ -0,0 +1,52 @@
+package cmd
+
+import (
+	"fmt"
+	"os"
+	"strings"
+
+	"github.com/spf13/cobra"
+	"github.com/techulus/push-cli/internal/config"
+)
+
+var configCmd = &cobra.Command{
+	Use:   "config",
+	Short: "Manage CLI configuration",
+}
+
+var setKeyCmd = &cobra.Command{
+	Use:   "set-key <api-key>",
+	Short: "Save your Push API key",
+	Args:  cobra.ExactArgs(1),
+	Run: func(cmd *cobra.Command, args []string) {
+		key := strings.TrimSpace(args[0])
+		if key == "" {
+			fmt.Fprintln(os.Stderr, "API key cannot be empty")
+			os.Exit(1)
+		}
+		if err := config.SetAPIKey(key); err != nil {
+			fmt.Fprintf(os.Stderr, "Error saving API key: %v\n", err)
+			os.Exit(1)
+		}
+		fmt.Println("API key saved successfully")
+	},
+}
+
+var showCmd = &cobra.Command{
+	Use:   "show",
+	Short: "Display current configuration",
+	Run: func(cmd *cobra.Command, args []string) {
+		key := config.GetAPIKey()
+		if key == "" {
+			fmt.Println("No API key configured. Run: push config set-key <api-key>")
+			return
+		}
+		fmt.Printf("API Key: %s\n", config.MaskedAPIKey())
+	},
+}
+
+func init() {
+	configCmd.AddCommand(setKeyCmd)
+	configCmd.AddCommand(showCmd)
+	rootCmd.AddCommand(configCmd)
+}

cmd/notify.go

@@ -0,0 +1,126 @@
+package cmd
+
+import (
+	"fmt"
+	"io"
+	"os"
+	"strings"
+
+	"github.com/spf13/cobra"
+	"github.com/techulus/push-cli/internal/api"
+	"github.com/techulus/push-cli/internal/config"
+)
+
+var validSounds = []string{
+	"default", "arcade", "correct", "fail", "harp", "reveal",
+	"bubble", "doorbell", "flute", "money", "scifi", "clear",
+	"elevator", "guitar", "pop",
+}
+
+func readBodyFromStdinOrFlag(cmd *cobra.Command) (string, error) {
+	body, _ := cmd.Flags().GetString("body")
+
+	if body == "-" || body == "" {
+		stat, _ := os.Stdin.Stat()
+		if (stat.Mode() & os.ModeCharDevice) == 0 {
+			data, err := io.ReadAll(os.Stdin)
+			if err != nil {
+				return "", fmt.Errorf("reading stdin: %w", err)
+			}
+			trimmed := strings.TrimSpace(string(data))
+			if trimmed == "" {
+				return "", fmt.Errorf("body is required (use --body flag or pipe via stdin)")
+			}
+			return trimmed, nil
+		}
+	}
+
+	if body == "" || body == "-" {
+		return "", fmt.Errorf("body is required (use --body flag or pipe via stdin)")
+	}
+
+	return body, nil
+}
+
+func buildNotifyRequest(cmd *cobra.Command) (api.NotifyRequest, error) {
+	title, _ := cmd.Flags().GetString("title")
+	body, err := readBodyFromStdinOrFlag(cmd)
+	if err != nil {
+		return api.NotifyRequest{}, err
+	}
+
+	sound, _ := cmd.Flags().GetString("sound")
+	if sound != "" {
+		valid := false
+		for _, s := range validSounds {
+			if s == sound {
+				valid = true
+				break
+			}
+		}
+		if !valid {
+			return api.NotifyRequest{}, fmt.Errorf("invalid sound %q, valid sounds: %s", sound, strings.Join(validSounds, ", "))
+		}
+	}
+
+	channel, _ := cmd.Flags().GetString("channel")
+	link, _ := cmd.Flags().GetString("link")
+	image, _ := cmd.Flags().GetString("image")
+	timeSensitive, _ := cmd.Flags().GetBool("time-sensitive")
+
+	return api.NotifyRequest{
+		Title:         title,
+		Body:          body,
+		Sound:         sound,
+		Channel:       channel,
+		Link:          link,
+		Image:         image,
+		TimeSensitive: timeSensitive,
+	}, nil
+}
+
+func newAPIClient() *api.Client {
+	key := config.GetAPIKey()
+	if key == "" {
+		fmt.Fprintln(os.Stderr, "No API key configured. Run: push config set-key <api-key>")
+		os.Exit(1)
+	}
+	return api.NewClient(key)
+}
+
+func addNotifyFlags(cmd *cobra.Command) {
+	cmd.Flags().String("title", "", "Notification title (required)")
+	cmd.Flags().String("body", "", "Notification body (use '-' to read from stdin)")
+	cmd.Flags().String("sound", "", "Notification sound")
+	cmd.Flags().String("channel", "", "Notification channel")
+	cmd.Flags().String("link", "", "URL to open when notification is tapped")
+	cmd.Flags().String("image", "", "Image URL for the notification")
+	cmd.Flags().Bool("time-sensitive", false, "Mark as time-sensitive")
+	cmd.MarkFlagRequired("title")
+}
+
+var notifyCmd = &cobra.Command{
+	Use:   "notify",
+	Short: "Send a push notification",
+	Run: func(cmd *cobra.Command, args []string) {
+		req, err := buildNotifyRequest(cmd)
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+			os.Exit(1)
+		}
+
+		client := newAPIClient()
+		resp, err := client.Notify(req)
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+			os.Exit(1)
+		}
+
+		fmt.Println(resp)
+	},
+}
+
+func init() {
+	addNotifyFlags(notifyCmd)
+	rootCmd.AddCommand(notifyCmd)
+}