bktide 1.0.1755266193 → 1.0.1755547716

package/README.md

@@ -1,6 +1,15 @@
 # bktide
 
-A command-line tool for interacting with Buildkite's GraphQL API.
+Command-line interface for Buildkite CI/CD workflows with rich shell completions (Fish, Bash, Zsh) and Alfred workflow integration for macOS power users.
+
+## Features
+
+- **🚀 Workflow Management**: View and manage builds, pipelines, organizations, and annotations
+- **🔧 Smart Shell Completions**: Context-aware completions for Fish, Bash, and Zsh
+- **🎯 Alfred Integration**: macOS Alfred workflow for quick access to Buildkite data
+- **📊 Multiple Output Formats**: Plain text, JSON, or Alfred-compatible output
+- **🔐 Secure Token Storage**: System keychain integration for API credentials
+- **⚡ Performance**: Built-in caching for faster repeated operations
 
 ## Installation
 
@@ -10,8 +19,34 @@ npm install -g bktide
 
 Once installed, use the `bktide` binary directly from your shell.
 
+## Shell Completions
+
+bktide supports auto-completion for Fish, Bash, and Zsh shells.
+
+### Quick Setup
+
+```bash
+# Fish
+bktide completions fish > ~/.config/fish/completions/bktide.fish
+
+# Bash
+echo 'source <(bktide completions bash)' >> ~/.bashrc
+
+# Zsh  
+echo 'source <(bktide completions zsh)' >> ~/.zshrc
+```
+
+Completions provide:
+- Command suggestions (`bktide <Tab>`)
+- Option completions (`bktide builds --<Tab>`)
+- Value completions (`bktide --format <Tab>`)
+- Dynamic completions for organizations and pipelines (Fish with jq installed)
+
+See [Shell Completions Guide](docs/shell-completions.md) for detailed installation and troubleshooting.
+
 ## Documentation
 
+- [Shell Completions](docs/shell-completions.md) - Complete guide for shell auto-completion setup
 - [Development Guide](docs/development.md) - Information about running and developing the CLI
 - [Authentication](docs/authentication.md) - How to authenticate with Buildkite
 - [Caching](docs/caching.md) - Information about the CLI's caching system
@@ -106,6 +141,18 @@ bktide annotations https://buildkite.com/gusto/zenpayroll/builds/1287418 --forma
 bktide annotations gusto/zenpayroll/1287418 --context build-resources --format json
 ```
 
+### Generate Shell Completions
+
+```bash
+# Generate completions for your shell
+bktide completions fish
+bktide completions bash
+bktide completions zsh
+
+# Auto-detect your shell and generate completions
+bktide completions
+```
+
 ## API Token
 
 You'll need a Buildkite API token with GraphQL scopes. Create one at:
@@ -126,6 +173,53 @@ bktide token --check   # See if a token is stored
 bktide token --reset   # Remove stored token
 ```
 
+## Visual Features
+
+The CLI provides a modern visual experience with color-coded information and clear hierarchy:
+
+### Color-Coded Build Status
+Build statuses are displayed with intuitive colors for quick scanning:
+- **Blue** (✓) - Passed builds
+- **Orange** (✖) - Failed builds  
+- **Cyan** (↻) - Running builds
+- **Yellow** (⚠) - Blocked/warning states
+- **Gray** (−) - Skipped/inactive states
+
+### Visual Hierarchy
+- **Bold + underlined headers** for table columns
+- **Cyan highlighting** for identifiers (#1234, IDs)
+- **Magenta** for numeric counts
+- **Dimmed text** for auxiliary information and tips
+- **Arrow indicators** (→) for actionable tips
+
+### Accessibility
+- **Colorblind-safe palette** - Uses blue/orange instead of green/red
+- **NO_COLOR support** - Set `NO_COLOR=1` for no colors
+- **ASCII mode** - Use `BKTIDE_ASCII=1` for screen reader compatibility
+- **Symbols with text fallbacks** - Information never relies solely on color
+
+### Smart Empty States
+When no results are found, helpful suggestions guide you:
+```
+No builds found
+
+Try specifying an organization with --org <name>
+Use --count to increase the number of results
+```
+
+### Enhanced Error Messages
+Errors provide clear context and actionable solutions:
+```
+✖ Error: Authentication Failed
+
+The provided token is invalid or expired.
+
+To fix this:
+  1. Get a new token from Buildkite
+  2. Run: bktide token --store
+  3. Try your command again
+```
+
 ## Global Options
 
 These flags work with all commands:
@@ -138,6 +232,18 @@ These flags work with all commands:
 - `-t, --token <token>`: provide Buildkite API token (or use `BK_TOKEN`)
 - `--save-token`: save token to system keychain
 - `-f, --format <format>`: plain|json|alfred (affects output and errors)
+- `--color <mode>`: auto|always|never (controls color in plain format)
+- `-q, --quiet`: suppress non-error output (success messages, tips)
+- `--tips`: show helpful tips after operations (default: true)
+- `--no-tips`: hide helpful tips
+
+### Output Behavior
+
+- Plain format (default): human-friendly output with color-coded statuses, bold headers, and visual hierarchy. Progress indicators (spinners for indeterminate operations, progress bars for operations with known totals) show during long operations only in interactive TTYs and are cleared on completion (no residual lines). Tips appear dimmed with arrow indicators (→) at the end of output.
+- JSON/Alfred formats: strictly machine-readable; no extra lines, no colors, no spinners or confirmations.
+- Streams: results go to stdout; errors go through the error formatter. When using `--format json|alfred`, only the formatted payload is printed.
+- Colors: by default `--color auto` enables color in TTYs with semantic coloring (blue for success, orange for errors, etc.). Use `--color never` or `NO_COLOR=1` to disable. Use `--color always` to force color in plain output.
+- Accessibility: Full functionality without colors - symbols provide visual cues (✓, ✖, ⚠, →) with ASCII fallbacks when `BKTIDE_ASCII=1` is set.
 
 # Logging System
 

package/WORKFLOW_README.md

@@ -1,6 +1,6 @@
 # bktide Alfred Workflow
 
-A powerful Alfred workflow for interacting with Buildkite builds, pipelines, and organizations.
+Streamline your Buildkite CI/CD workflows directly from Alfred. Instantly access builds, pipelines, and organizations without leaving your keyboard.
 
 ## Quick Start
 

package/completions/bktide-dynamic.fish

@@ -0,0 +1,171 @@
+# Fish completions for bktide CLI with dynamic completions
+# Install by copying to ~/.config/fish/completions/bktide.fish
+# Or run: bktide completions fish > ~/.config/fish/completions/bktide.fish
+
+# Disable file completions for all bktide commands by default
+complete -c bktide -f
+complete -c bin/bktide -f
+
+# Helper function to get organizations dynamically
+function __fish_bktide_orgs
+    # Try to get organizations, suppress errors
+    bktide orgs --format json --quiet 2>/dev/null | jq -r '.[].slug' 2>/dev/null
+end
+
+# Helper function to get pipelines dynamically
+function __fish_bktide_pipelines
+    set -l org_arg
+    # Try to find the --org value from the command line
+    set -l cmd (commandline -opc)
+    set -l found_org 0
+    for i in (seq (count $cmd))
+        if test "$found_org" = "1"
+            set org_arg "--org $cmd[$i]"
+            break
+        end
+        if test "$cmd[$i]" = "--org" -o "$cmd[$i]" = "-o"
+            set found_org 1
+        end
+    end
+    
+    # Get pipelines for the org (or all if no org specified)
+    if test -n "$org_arg"
+        bktide pipelines $org_arg --format json --quiet 2>/dev/null | jq -r '.[].slug' 2>/dev/null
+    else
+        bktide pipelines --format json --quiet 2>/dev/null | jq -r '.[].slug' 2>/dev/null
+    end
+end
+
+# Helper function to get branches (commonly used ones)
+function __fish_bktide_branches
+    # Common branch names - you could enhance this to get from git if in a repo
+    echo main
+    echo master
+    echo develop
+    echo staging
+    echo production
+    # Try to get branches from current git repo if available
+    git branch -r 2>/dev/null | sed 's/.*origin\///' | grep -v HEAD 2>/dev/null
+end
+
+# Helper function to check if we're in the project directory for bin/bktide
+function __fish_bktide_use_bin
+    # Check if bin/bktide exists in current or parent directories
+    if test -x ./bin/bktide
+        return 0
+    else if test -x ../bin/bktide
+        return 0
+    else if test -x ../../bin/bktide
+        return 0
+    end
+    return 1
+end
+
+# Main commands
+complete -c bktide -n __fish_use_subcommand -a viewer -d "Show logged in user information"
+complete -c bktide -n __fish_use_subcommand -a orgs -d "List organizations"
+complete -c bktide -n __fish_use_subcommand -a pipelines -d "List pipelines for an organization"
+complete -c bktide -n __fish_use_subcommand -a builds -d "List builds for the current user"
+complete -c bktide -n __fish_use_subcommand -a token -d "Manage API tokens"
+complete -c bktide -n __fish_use_subcommand -a annotations -d "Show annotations for a build"
+complete -c bktide -n __fish_use_subcommand -a completions -d "Generate shell completions"
+complete -c bktide -n __fish_use_subcommand -a boom -d "Test error handling"
+
+# Global options (available for all commands)
+complete -c bktide -l log-level -d "Set logging level" -xa "trace debug info warn error fatal"
+complete -c bktide -s d -l debug -d "Show debug information for errors"
+complete -c bktide -l no-cache -d "Disable caching of API responses"
+complete -c bktide -l cache-ttl -d "Set cache time-to-live in milliseconds" -x
+complete -c bktide -l clear-cache -d "Clear all cached data before executing command"
+complete -c bktide -s t -l token -d "Buildkite API token" -x
+complete -c bktide -l save-token -d "Save the token to system keychain for future use"
+complete -c bktide -s f -l format -d "Output format" -xa "plain json alfred"
+complete -c bktide -l color -d "Color output mode" -xa "auto always never"
+complete -c bktide -s q -l quiet -d "Suppress non-error output (plain format only)"
+complete -c bktide -l tips -d "Show helpful tips and suggestions"
+complete -c bktide -l no-tips -d "Hide helpful tips and suggestions"
+complete -c bktide -l ascii -d "Use ASCII symbols instead of Unicode"
+complete -c bktide -s h -l help -d "Show help"
+complete -c bktide -s V -l version -d "Show version"
+
+# Pipelines command options with dynamic org completion
+complete -c bktide -n "__fish_seen_subcommand_from pipelines" -s o -l org -d "Organization slug" -xa "(__fish_bktide_orgs)"
+complete -c bktide -n "__fish_seen_subcommand_from pipelines" -s n -l count -d "Limit to specified number of pipelines" -x
+complete -c bktide -n "__fish_seen_subcommand_from pipelines" -l filter -d "Filter pipelines by name (case insensitive)" -x
+
+# Builds command options with dynamic completions
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s o -l org -d "Organization slug" -xa "(__fish_bktide_orgs)"
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s p -l pipeline -d "Filter by pipeline slug" -xa "(__fish_bktide_pipelines)"
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s b -l branch -d "Filter by branch name" -xa "(__fish_bktide_branches)"
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s s -l state -d "Filter by build state" -xa "running scheduled passed failing failed canceled blocked canceling skipped not_run"
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s n -l count -d "Number of builds per page" -x
+complete -c bktide -n "__fish_seen_subcommand_from builds" -l page -d "Page number" -x
+complete -c bktide -n "__fish_seen_subcommand_from builds" -l filter -d "Fuzzy filter builds" -x
+
+# Token command options
+complete -c bktide -n "__fish_seen_subcommand_from token" -l check -d "Check if a token is stored"
+complete -c bktide -n "__fish_seen_subcommand_from token" -l store -d "Store a token in the system keychain"
+complete -c bktide -n "__fish_seen_subcommand_from token" -l reset -d "Delete the stored token"
+
+# Annotations command - build reference examples
+complete -c bktide -n "__fish_seen_subcommand_from annotations" -a "org/pipeline/123" -d "Example: org/pipeline/build-number"
+complete -c bktide -n "__fish_seen_subcommand_from annotations" -l context -d "Filter annotations by context" -x
+
+# Completions command options
+complete -c bktide -n "__fish_seen_subcommand_from completions" -a "fish bash zsh" -d "Shell type"
+
+# Boom command options (for testing)
+complete -c bktide -n "__fish_seen_subcommand_from boom" -l type -d "Type of error to throw" -xa "basic api object"
+
+# Also support bin/bktide for local development
+# Copy all the same completions for bin/bktide
+complete -c bin/bktide -n __fish_use_subcommand -a viewer -d "Show logged in user information"
+complete -c bin/bktide -n __fish_use_subcommand -a orgs -d "List organizations"
+complete -c bin/bktide -n __fish_use_subcommand -a pipelines -d "List pipelines for an organization"
+complete -c bin/bktide -n __fish_use_subcommand -a builds -d "List builds for the current user"
+complete -c bin/bktide -n __fish_use_subcommand -a token -d "Manage API tokens"
+complete -c bin/bktide -n __fish_use_subcommand -a annotations -d "Show annotations for a build"
+complete -c bin/bktide -n __fish_use_subcommand -a completions -d "Generate shell completions"
+complete -c bin/bktide -n __fish_use_subcommand -a boom -d "Test error handling"
+
+# Global options for bin/bktide
+complete -c bin/bktide -l log-level -d "Set logging level" -xa "trace debug info warn error fatal"
+complete -c bin/bktide -s d -l debug -d "Show debug information for errors"
+complete -c bin/bktide -l no-cache -d "Disable caching of API responses"
+complete -c bin/bktide -l cache-ttl -d "Set cache time-to-live in milliseconds" -x
+complete -c bin/bktide -l clear-cache -d "Clear all cached data before executing command"
+complete -c bin/bktide -s t -l token -d "Buildkite API token" -x
+complete -c bin/bktide -l save-token -d "Save the token to system keychain for future use"
+complete -c bin/bktide -s f -l format -d "Output format" -xa "plain json alfred"
+complete -c bin/bktide -l color -d "Color output mode" -xa "auto always never"
+complete -c bin/bktide -s q -l quiet -d "Suppress non-error output (plain format only)"
+complete -c bin/bktide -l tips -d "Show helpful tips and suggestions"
+complete -c bin/bktide -l no-tips -d "Hide helpful tips and suggestions"
+complete -c bin/bktide -l ascii -d "Use ASCII symbols instead of Unicode"
+complete -c bin/bktide -s h -l help -d "Show help"
+complete -c bin/bktide -s V -l version -d "Show version"
+
+# Command-specific options for bin/bktide with dynamic completions
+complete -c bin/bktide -n "__fish_seen_subcommand_from pipelines" -s o -l org -d "Organization slug" -xa "(__fish_bktide_orgs)"
+complete -c bin/bktide -n "__fish_seen_subcommand_from pipelines" -s n -l count -d "Limit to specified number of pipelines" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from pipelines" -l filter -d "Filter pipelines by name (case insensitive)" -x
+
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s o -l org -d "Organization slug" -xa "(__fish_bktide_orgs)"
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s p -l pipeline -d "Filter by pipeline slug" -xa "(__fish_bktide_pipelines)"
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s b -l branch -d "Filter by branch name" -xa "(__fish_bktide_branches)"
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s s -l state -d "Filter by build state" -xa "running scheduled passed failing failed canceled blocked canceling skipped not_run"
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s n -l count -d "Number of builds per page" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -l page -d "Page number" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -l filter -d "Fuzzy filter builds" -x
+
+complete -c bin/bktide -n "__fish_seen_subcommand_from token" -l check -d "Check if a token is stored"
+complete -c bin/bktide -n "__fish_seen_subcommand_from token" -l store -d "Store a token in the system keychain"
+complete -c bin/bktide -n "__fish_seen_subcommand_from token" -l reset -d "Delete the stored token"
+
+complete -c bin/bktide -n "__fish_seen_subcommand_from annotations" -a "org/pipeline/123" -d "Example: org/pipeline/build-number"
+complete -c bin/bktide -n "__fish_seen_subcommand_from annotations" -l context -d "Filter annotations by context" -x
+
+complete -c bin/bktide -n "__fish_seen_subcommand_from completions" -a "fish bash zsh" -d "Shell type"
+
+complete -c bin/bktide -n "__fish_seen_subcommand_from boom" -l type -d "Type of error to throw" -xa "basic api object"
+

package/completions/bktide.bash

@@ -0,0 +1,124 @@
+#!/bin/bash
+# Bash completions for bktide CLI
+# Install by adding to ~/.bashrc: source <(bktide completions bash)
+# Or copy to /etc/bash_completion.d/bktide
+
+_bktide() {
+    local cur prev words cword
+    _init_completion || return
+
+    local commands="viewer orgs pipelines builds token annotations completions boom"
+    local global_opts="--log-level --debug --no-cache --cache-ttl --clear-cache --token --save-token --format --color --quiet --tips --no-tips --ascii --help --version"
+    
+    # First argument - complete with commands
+    if [[ $cword -eq 1 ]]; then
+        COMPREPLY=( $(compgen -W "$commands" -- "$cur") )
+        return 0
+    fi
+
+    local cmd="${words[1]}"
+    
+    # Handle global options
+    case "$prev" in
+        --log-level)
+            COMPREPLY=( $(compgen -W "trace debug info warn error fatal" -- "$cur") )
+            return 0
+            ;;
+        --format|-f)
+            COMPREPLY=( $(compgen -W "plain json alfred" -- "$cur") )
+            return 0
+            ;;
+        --color)
+            COMPREPLY=( $(compgen -W "auto always never" -- "$cur") )
+            return 0
+            ;;
+    esac
+
+    # Command-specific completions
+    case "$cmd" in
+        pipelines)
+            local opts="--org --count --filter $global_opts"
+            if [[ "$prev" == "--org" || "$prev" == "-o" ]]; then
+                # Dynamic org completion (if bktide is working)
+                local orgs=$(bktide orgs --format json --quiet 2>/dev/null | jq -r '.[].slug' 2>/dev/null)
+                if [[ -n "$orgs" ]]; then
+                    COMPREPLY=( $(compgen -W "$orgs" -- "$cur") )
+                    return 0
+                fi
+            fi
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+            
+        builds)
+            local opts="--org --pipeline --branch --state --count --page --filter $global_opts"
+            case "$prev" in
+                --org|-o)
+                    # Dynamic org completion
+                    local orgs=$(bktide orgs --format json --quiet 2>/dev/null | jq -r '.[].slug' 2>/dev/null)
+                    if [[ -n "$orgs" ]]; then
+                        COMPREPLY=( $(compgen -W "$orgs" -- "$cur") )
+                        return 0
+                    fi
+                    ;;
+                --pipeline|-p)
+                    # Dynamic pipeline completion
+                    local pipelines=$(bktide pipelines --format json --quiet 2>/dev/null | jq -r '.[].slug' 2>/dev/null)
+                    if [[ -n "$pipelines" ]]; then
+                        COMPREPLY=( $(compgen -W "$pipelines" -- "$cur") )
+                        return 0
+                    fi
+                    ;;
+                --branch|-b)
+                    # Git branches if in a repo
+                    local branches="main master develop staging production"
+                    if git rev-parse --git-dir &>/dev/null; then
+                        branches="$branches $(git branch -r 2>/dev/null | sed 's/.*origin\///' | grep -v HEAD)"
+                    fi
+                    COMPREPLY=( $(compgen -W "$branches" -- "$cur") )
+                    return 0
+                    ;;
+                --state|-s)
+                    COMPREPLY=( $(compgen -W "running scheduled passed failing failed canceled blocked canceling skipped not_run" -- "$cur") )
+                    return 0
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+            
+        token)
+            local opts="--check --store --reset $global_opts"
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+            
+        annotations)
+            local opts="--context $global_opts"
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+            
+        completions)
+            if [[ $cword -eq 2 ]]; then
+                COMPREPLY=( $(compgen -W "fish bash zsh" -- "$cur") )
+            else
+                COMPREPLY=( $(compgen -W "$global_opts" -- "$cur") )
+            fi
+            ;;
+            
+        boom)
+            local opts="--type $global_opts"
+            if [[ "$prev" == "--type" ]]; then
+                COMPREPLY=( $(compgen -W "basic api object" -- "$cur") )
+                return 0
+            fi
+            COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+            ;;
+            
+        *)
+            COMPREPLY=( $(compgen -W "$global_opts" -- "$cur") )
+            ;;
+    esac
+}
+
+# Register completions for both bktide and bin/bktide
+complete -F _bktide bktide
+complete -F _bktide bin/bktide
+

package/completions/bktide.fish

@@ -0,0 +1,107 @@
+# Fish completions for bktide CLI
+# Install by copying to ~/.config/fish/completions/bktide.fish
+# Or run: bktide completions fish > ~/.config/fish/completions/bktide.fish
+
+# Disable file completions for all bktide commands by default
+complete -c bktide -f
+complete -c bin/bktide -f
+
+# Main commands
+complete -c bktide -n __fish_use_subcommand -a viewer -d "Show logged in user information"
+complete -c bktide -n __fish_use_subcommand -a orgs -d "List organizations"
+complete -c bktide -n __fish_use_subcommand -a pipelines -d "List pipelines for an organization"
+complete -c bktide -n __fish_use_subcommand -a builds -d "List builds for the current user"
+complete -c bktide -n __fish_use_subcommand -a token -d "Manage API tokens"
+complete -c bktide -n __fish_use_subcommand -a annotations -d "Show annotations for a build"
+complete -c bktide -n __fish_use_subcommand -a boom -d "Test error handling"
+
+# Global options (available for all commands)
+complete -c bktide -l log-level -d "Set logging level" -xa "trace debug info warn error fatal"
+complete -c bktide -s d -l debug -d "Show debug information for errors"
+complete -c bktide -l no-cache -d "Disable caching of API responses"
+complete -c bktide -l cache-ttl -d "Set cache time-to-live in milliseconds" -x
+complete -c bktide -l clear-cache -d "Clear all cached data before executing command"
+complete -c bktide -s t -l token -d "Buildkite API token" -x
+complete -c bktide -l save-token -d "Save the token to system keychain for future use"
+complete -c bktide -s f -l format -d "Output format" -xa "plain json alfred"
+complete -c bktide -l color -d "Color output mode" -xa "auto always never"
+complete -c bktide -s q -l quiet -d "Suppress non-error output (plain format only)"
+complete -c bktide -l tips -d "Show helpful tips and suggestions"
+complete -c bktide -l no-tips -d "Hide helpful tips and suggestions"
+complete -c bktide -l ascii -d "Use ASCII symbols instead of Unicode"
+complete -c bktide -s h -l help -d "Show help"
+complete -c bktide -s V -l version -d "Show version"
+
+# Pipelines command options
+complete -c bktide -n "__fish_seen_subcommand_from pipelines" -s o -l org -d "Organization slug" -x
+complete -c bktide -n "__fish_seen_subcommand_from pipelines" -s n -l count -d "Limit to specified number of pipelines" -x
+complete -c bktide -n "__fish_seen_subcommand_from pipelines" -l filter -d "Filter pipelines by name (case insensitive)" -x
+
+# Builds command options
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s o -l org -d "Organization slug" -x
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s p -l pipeline -d "Filter by pipeline slug" -x
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s b -l branch -d "Filter by branch name" -x
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s s -l state -d "Filter by build state" -xa "running scheduled passed failing failed canceled blocked canceling skipped not_run"
+complete -c bktide -n "__fish_seen_subcommand_from builds" -s n -l count -d "Number of builds per page" -x
+complete -c bktide -n "__fish_seen_subcommand_from builds" -l page -d "Page number" -x
+complete -c bktide -n "__fish_seen_subcommand_from builds" -l filter -d "Fuzzy filter builds" -x
+
+# Token command options
+complete -c bktide -n "__fish_seen_subcommand_from token" -l check -d "Check if a token is stored"
+complete -c bktide -n "__fish_seen_subcommand_from token" -l store -d "Store a token in the system keychain"
+complete -c bktide -n "__fish_seen_subcommand_from token" -l reset -d "Delete the stored token"
+
+# Annotations command options
+complete -c bktide -n "__fish_seen_subcommand_from annotations" -l context -d "Filter annotations by context" -x
+
+# Boom command options (for testing)
+complete -c bktide -n "__fish_seen_subcommand_from boom" -l type -d "Type of error to throw" -xa "basic api object"
+
+# Also support bin/bktide for local development
+# Copy all the same completions for bin/bktide
+complete -c bin/bktide -n __fish_use_subcommand -a viewer -d "Show logged in user information"
+complete -c bin/bktide -n __fish_use_subcommand -a orgs -d "List organizations"
+complete -c bin/bktide -n __fish_use_subcommand -a pipelines -d "List pipelines for an organization"
+complete -c bin/bktide -n __fish_use_subcommand -a builds -d "List builds for the current user"
+complete -c bin/bktide -n __fish_use_subcommand -a token -d "Manage API tokens"
+complete -c bin/bktide -n __fish_use_subcommand -a annotations -d "Show annotations for a build"
+complete -c bin/bktide -n __fish_use_subcommand -a boom -d "Test error handling"
+
+# Global options for bin/bktide
+complete -c bin/bktide -l log-level -d "Set logging level" -xa "trace debug info warn error fatal"
+complete -c bin/bktide -s d -l debug -d "Show debug information for errors"
+complete -c bin/bktide -l no-cache -d "Disable caching of API responses"
+complete -c bin/bktide -l cache-ttl -d "Set cache time-to-live in milliseconds" -x
+complete -c bin/bktide -l clear-cache -d "Clear all cached data before executing command"
+complete -c bin/bktide -s t -l token -d "Buildkite API token" -x
+complete -c bin/bktide -l save-token -d "Save the token to system keychain for future use"
+complete -c bin/bktide -s f -l format -d "Output format" -xa "plain json alfred"
+complete -c bin/bktide -l color -d "Color output mode" -xa "auto always never"
+complete -c bin/bktide -s q -l quiet -d "Suppress non-error output (plain format only)"
+complete -c bin/bktide -l tips -d "Show helpful tips and suggestions"
+complete -c bin/bktide -l no-tips -d "Hide helpful tips and suggestions"
+complete -c bin/bktide -l ascii -d "Use ASCII symbols instead of Unicode"
+complete -c bin/bktide -s h -l help -d "Show help"
+complete -c bin/bktide -s V -l version -d "Show version"
+
+# Command-specific options for bin/bktide
+complete -c bin/bktide -n "__fish_seen_subcommand_from pipelines" -s o -l org -d "Organization slug" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from pipelines" -s n -l count -d "Limit to specified number of pipelines" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from pipelines" -l filter -d "Filter pipelines by name (case insensitive)" -x
+
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s o -l org -d "Organization slug" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s p -l pipeline -d "Filter by pipeline slug" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s b -l branch -d "Filter by branch name" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s s -l state -d "Filter by build state" -xa "running scheduled passed failing failed canceled blocked canceling skipped not_run"
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -s n -l count -d "Number of builds per page" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -l page -d "Page number" -x
+complete -c bin/bktide -n "__fish_seen_subcommand_from builds" -l filter -d "Fuzzy filter builds" -x
+
+complete -c bin/bktide -n "__fish_seen_subcommand_from token" -l check -d "Check if a token is stored"
+complete -c bin/bktide -n "__fish_seen_subcommand_from token" -l store -d "Store a token in the system keychain"
+complete -c bin/bktide -n "__fish_seen_subcommand_from token" -l reset -d "Delete the stored token"
+
+complete -c bin/bktide -n "__fish_seen_subcommand_from annotations" -l context -d "Filter annotations by context" -x
+
+complete -c bin/bktide -n "__fish_seen_subcommand_from boom" -l type -d "Type of error to throw" -xa "basic api object"
+