Update files

Author: obay

.github/DESCRIPTION.md

@@ -0,0 +1,37 @@
+# GitHub Repository Description
+
+Use this description for your GitHub repository:
+
+```
+A powerful CLI tool written in Go for managing HubSpot contacts. Perform CRUD operations, search, and automate contact management directly from your terminal.
+```
+
+## Short Description (for GitHub Topics)
+
+```
+CLI tool for HubSpot contact management with CRUD operations, search, and automation capabilities.
+```
+
+## Topics/Tags to Add
+
+Add these topics to your repository:
+- `hubspot`
+- `cli`
+- `go`
+- `golang`
+- `contact-management`
+- `crm`
+- `command-line`
+- `automation`
+- `hubspot-api`
+- `contacts`
+
+## How to Update Repository Description
+
+1. Go to your repository on GitHub: `https://github.com/obay/hsctl`
+2. Click the ⚙️ (Settings) icon or go to Settings
+3. Scroll down to "About" section
+4. Paste the description above
+5. Add the topics listed above
+6. Save changes
+

.github/workflows/scoop-update.yml

@@ -11,7 +11,7 @@ jobs:
       - name: Checkout Scoop Bucket
         uses: actions/checkout@v4
         with:
-          repository: obay/hsctl-scoop
+          repository: obay/scoop-bucket
           token: ${{ secrets.SCOOP_BUCKET_TOKEN }}
           path: scoop-bucket
 

.goreleaser.yml

@@ -23,6 +23,7 @@ builds:
       - -s -w -X github.com/obay/hsctl/cmd.version={{.Version}} -X github.com/obay/hsctl/cmd.commit={{.Commit}} -X github.com/obay/hsctl/cmd.buildDate={{.Date}}
 
 archives:
+  # Versioned archives (standard)
   - format: tar.gz
     name_template: "{{ .ProjectName }}_{{ .Os }}_{{ .Arch }}_{{ .Version }}"
     files:
@@ -31,6 +32,15 @@ archives:
     format_overrides:
       - goos: windows
         format: zip
+  # Version-less archives for easier direct downloads via /latest/download/
+  - format: tar.gz
+    name_template: "{{ .ProjectName }}_{{ .Os }}_{{ .Arch }}"
+    files:
+      - README.md
+      - LICENSE
+    format_overrides:
+      - goos: windows
+        format: zip
 
 checksum:
   name_template: 'checksums.txt'
@@ -58,16 +68,19 @@ release:
 scoop:
   bucket:
     owner: obay
-    name: hsctl-scoop
+    name: scoop-bucket
   homepage: "https://github.com/obay/hsctl"
   description: "A CLI tool for managing HubSpot contacts"
   license: "MIT"
   persist:
     - config
-  skip_upload: true  # Set to false after creating the scoop bucket repository
+  skip_upload: false
 
 brews:
   - name: hsctl
+    tap:
+      owner: obay
+      name: homebrew-tap
     homepage: "https://github.com/obay/hsctl"
     description: "A CLI tool for managing HubSpot contacts"
     license: "MIT"

GITHUB_SETUP.md

@@ -0,0 +1,138 @@
+# GitHub Repository Setup Guide
+
+This guide will help you set up your GitHub repository with a proper description and ensure downloadable packages are available.
+
+## Step 1: Add Repository Description
+
+1. Go to your repository: `https://github.com/obay/hsctl`
+2. Click the **⚙️ Settings** icon (or navigate to Settings)
+3. Scroll down to the **"About"** section
+4. Click the **✏️ Edit** icon
+5. Paste this description:
+
+```
+A powerful CLI tool written in Go for managing HubSpot contacts. Perform CRUD operations, search, and automate contact management directly from your terminal.
+```
+
+6. Add the following **Topics** (tags):
+   - `hubspot`
+   - `cli`
+   - `go`
+   - `golang`
+   - `contact-management`
+   - `crm`
+   - `command-line`
+   - `automation`
+   - `hubspot-api`
+   - `contacts`
+
+7. Click **Save changes**
+
+## Step 2: Verify Release Assets
+
+After your first release, GoReleaser will automatically create downloadable packages. Verify that these are available:
+
+### What Gets Created
+
+For each release, GoReleaser creates:
+
+1. **Versioned Archives** (with version number):
+   - `hsctl_darwin_amd64_v1.0.0.tar.gz`
+   - `hsctl_darwin_arm64_v1.0.0.tar.gz`
+   - `hsctl_linux_amd64_v1.0.0.tar.gz`
+   - `hsctl_linux_arm64_v1.0.0.tar.gz`
+   - `hsctl_windows_amd64_v1.0.0.zip`
+
+2. **Version-less Archives** (for `/latest/download/` URLs):
+   - `hsctl_darwin_amd64.tar.gz`
+   - `hsctl_darwin_arm64.tar.gz`
+   - `hsctl_linux_amd64.tar.gz`
+   - `hsctl_linux_arm64.tar.gz`
+   - `hsctl_windows_amd64.zip`
+
+3. **Package Files**:
+   - `hsctl_linux_amd64.deb` (Debian/Ubuntu)
+   - `hsctl_linux_amd64.rpm` (Red Hat/CentOS/Fedora)
+
+4. **Checksums**:
+   - `checksums.txt` (for verifying downloads)
+
+### Testing Direct Downloads
+
+After creating a release, test these URLs:
+
+```bash
+# macOS Intel
+curl -LO https://github.com/obay/hsctl/releases/latest/download/hsctl_darwin_amd64.tar.gz
+
+# macOS Apple Silicon
+curl -LO https://github.com/obay/hsctl/releases/latest/download/hsctl_darwin_arm64.tar.gz
+
+# Linux
+curl -LO https://github.com/obay/hsctl/releases/latest/download/hsctl_linux_amd64.tar.gz
+
+# Windows
+curl -LO https://github.com/obay/hsctl/releases/latest/download/hsctl_windows_amd64.zip
+```
+
+## Step 3: Create Your First Release
+
+1. **Tag your release**:
+   ```bash
+   git tag -a v0.1.0 -m "Initial release"
+   git push origin v0.1.0
+   ```
+
+2. **GitHub Actions will automatically**:
+   - Build binaries for all platforms
+   - Create archives (tar.gz and zip)
+   - Generate package files (.deb, .rpm)
+   - Create a GitHub release
+   - Upload all assets
+
+3. **Verify the release**:
+   - Go to: `https://github.com/obay/hsctl/releases`
+   - Check that all assets are listed
+   - Test downloading one of the assets
+
+## Step 4: Update README Links (if needed)
+
+The README already includes direct download links. After your first release, verify that the links work:
+
+- All `/latest/download/` URLs should redirect to the latest release
+- Versioned URLs will point to specific releases
+- Checksums file should be available
+
+## Troubleshooting
+
+### No Assets in Release
+
+If assets aren't appearing:
+1. Check GitHub Actions logs for errors
+2. Verify GoReleaser configuration (`.goreleaser.yml`)
+3. Ensure the workflow has proper permissions
+
+### Download Links Don't Work
+
+If `/latest/download/` URLs don't work:
+1. Verify the asset filenames match exactly
+2. Check that the release is marked as "Latest"
+3. Ensure the release is published (not draft)
+
+### Missing Package Files
+
+If .deb or .rpm files are missing:
+1. Check the `nfpms` section in `.goreleaser.yml`
+2. Verify Linux builds are successful
+3. Check GitHub Actions logs
+
+## Next Steps
+
+- ✅ Repository description added
+- ✅ Topics/tags added
+- ✅ First release created
+- ✅ Download links verified
+- ✅ Package managers set up (Scoop, Homebrew)
+
+Your repository is now ready for users to download and install HSCTL!
+

INSTALL.md

@@ -15,7 +15,7 @@ This guide provides detailed installation instructions for HSCTL on different pl
 
 1. Add the tap:
    ```bash
-   brew tap obay/hsctl
+   brew tap obay/homebrew-tap
    ```
 
 2. Install:
@@ -62,7 +62,7 @@ This guide provides detailed installation instructions for HSCTL on different pl
 
 2. Add the bucket:
    ```powershell
-   scoop bucket add hsctl https://github.com/obay/hsctl-scoop
+   scoop bucket add obay https://github.com/obay/scoop-bucket
    ```
 
 3. Install: