luciq-cli 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6882405a8d129fe6337191a3fafcf09ce88290166b640acb36c016af9c4bdd35
-  data.tar.gz: 866a5f76f6d8d1b922b24c73dc33687c9a9cd7dc8a139722d449c129b8e474a5
+  metadata.gz: 8a0f4b1ed57b62e9807f17afddbd5e34b5fa411d504cd2fdabd5afc50521650c
+  data.tar.gz: b25294d1c535c880a7d8be44385bce9ccdc49bd8be7245ae8417d031177aad27
 SHA512:
-  metadata.gz: 2c48c7bbb0a56349d8bd41e9ad78a7b4c459a50e0befa5dd1b69a2eb98beca174c3fb1cfdbfba1d2815b55ab9b8eb96b75738f5b49abf4c9ee45d19b9bc208e9
-  data.tar.gz: 5eb8bc3833309adfb682cfcf3c13b2c4690803a4086df71f8fa8b6d23be99b865bdcbbb144d390d65b0b4f46b6e6377da79e894dfb168daac14bdd795729f561
+  metadata.gz: cf5b2166bc9f2e6910feab38b73d90187d9a928d3207e703bcc97faa55fcd84b6398362150300207c850d49460d9c200e65957615be10c4309e0e61a7ec8e9af
+  data.tar.gz: f90266fa97e558b083630cda382d9febe7421a3e3f9c4e03935c93819e28ab26510ed6e2c1d154666b5aa634b44d74f667686155c5783c4b5e10510cf90a8999

data/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-08-04
+
+### Changed
+
+- **Breaking:** `luciq upload` commands now take `--slug` and `--mode` instead of `--app-token`, matching the query commands. Uploads authenticate with your CLI login, so no application token is needed.
+- `luciq whoami` and `luciq upload` now call the Luciq API gateway instead of the public backend endpoints.
+
+### Added
+
+- `--tag-action` on `luciq bugs update` to control how `--tags` is applied: `append` (default), `replace`, or `remove`
+- Homebrew installation: `brew install luciqai/tap/luciq-cli`
+- MIT LICENSE
+
+### Fixed
+
+- `luciq bugs update` now rejects `--clear-tags` combined with `--tag-action`, and no longer treats a tags-only change as an empty update
+- Corrected the dashboard URL shown for creating a CLI token
+
 ## [0.2.0] - 2026-07-05
 
 ### Added

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Instabug, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -15,14 +15,13 @@ gem install luciq-cli
 ### Using Homebrew (macOS/Linux)
 
 ```bash
-brew tap instabug/tap
-brew install luciq-cli
+brew install luciqai/tap/luciq-cli
 ```
 
 ### From Source
 
 ```bash
-git clone https://github.com/Instabug/luciq-cli.git
+git clone https://github.com/luciqai/luciq-cli.git
 cd luciq-cli
 bundle install
 bundle exec rake install
@@ -32,7 +31,7 @@ bundle exec rake install
 
 ### 1. Authenticate
 
-Generate a CLI token from your [Luciq Dashboard](https://dashboard.luciq.ai/company/cli), then:
+Generate a CLI token from your [Luciq Dashboard](https://dashboard.luciq.ai/company/luciq-cli), then:
 
 > **Self-hosted clusters:** Replace `dashboard.luciq.ai` with your cluster URL.
 
@@ -52,14 +51,16 @@ Upload Android mapping files (`mapping.txt`):
 
 ```bash
 luciq upload android-mapping mapping.txt \
-  --app-token YOUR_APP_TOKEN \
+  --slug my-app \
+  --mode production \
   --version-name 1.0.0 \
   --version-code 1
 ```
 
 | Option | Description |
 |--------|-------------|
-| `--app-token` | Luciq application token (required) |
+| `--slug` | Application slug (required) |
+| `--mode` | Application mode, e.g., `production` (required) |
 | `--version-name` | App version name, e.g., `1.0.0` (required) |
 | `--version-code` | App version code, e.g., `1` (required) |
 
@@ -125,11 +126,13 @@ Run `luciq upload help SUBCOMMAND` for the full options of any command.
 | `luciq upload flutter-android-sourcemap FILE` | `.zip` | Android Dart symbol files |
 | `luciq upload flutter-ndk FILE` | `.zip` | NDK `.so` shared object files (`--arch`) |
 
-Common options: `--app-token` is required for every command. dSYM commands
-(`*-ios-dsym`) need only `--app-token`. Mapping, source-map, and Flutter Dart-symbol
-commands also require `--version-name` / `--version-code` (React Native source-map
-commands additionally accept `--codepush`). NDK commands require `--version-name` and
-`--arch` (`armeabi-v7a`, `arm64-v8a`, `x86`, `x86_64`) — not `--version-code`.
+Common options: `--slug` and `--mode` are required for every command — uploads use
+your CLI login, the same as query commands. dSYM commands (`*-ios-dsym`) need only
+`--slug` / `--mode`. Mapping, source-map, and
+Flutter Dart-symbol commands also require `--version-name` / `--version-code`
+(React Native source-map commands additionally accept `--codepush`). NDK commands
+require `--version-name` and `--arch` (`armeabi-v7a`, `arm64-v8a`, `x86`, `x86_64`)
+— not `--version-code`.
 
 ## Query & management commands
 
@@ -183,16 +186,20 @@ luciq crashes show --slug my-app --mode production --number 42
 |------------|-------------|
 | `list` | List bugs. Flags: `--status` (new/closed/in_progress), `--priority` (na/trivial/minor/major/blocker), `--app-version` |
 | `show --number N` | Details for one bug |
-| `update --number N` | Update a bug. Flags: `--status`, `--priority`, `--tags`, `--clear-tags`, `--duplicate-of`, `--action` |
+| `update --number N` | Update a bug. Flags: `--status`, `--priority`, `--tags`, `--tag-action`, `--clear-tags`, `--duplicate-of`, `--action` |
 
 ```bash
 luciq bugs update --slug my-app --mode production --number 7 --status closed --priority major
 luciq bugs update --slug my-app --mode production --number 7 --duplicate-of 3
+luciq bugs update --slug my-app --mode production --number 7 --tags urgent regression
+luciq bugs update --slug my-app --mode production --number 7 --tags stale --tag-action remove
+luciq bugs update --slug my-app --mode production --number 7 --tags only-this --tag-action replace
 ```
 
 Provide at least one change. Duplicate marking (`--duplicate-of` / `--action`)
-can't be combined with `--status`/`--priority`; use `--clear-tags` to remove all
-tags.
+can't be combined with `--status`/`--priority`. Tags: `--tags` appends to the existing
+tags by default; `--tag-action replace` sets `--tags` as the full list (removing others),
+`--tag-action remove` deletes `--tags` and keeps the rest; `--clear-tags` removes all.
 
 ### APM
 
@@ -320,14 +327,25 @@ url=https://api.your-cluster.luciq.ai
 
 ## Development
 
-```bash
-git clone https://github.com/Instabug/luciq-cli.git
-cd luciq-cli
-bundle install
+Clone the repo and install dependencies as in [From Source](#from-source), then:
 
+```bash
 # Run tests
 bundle exec rspec
 
 # Test locally
 bundle exec bin/luciq --help
 ```
+
+## Releasing
+
+After publishing a new gem version to RubyGems, sync the Homebrew formula in
+the [homebrew-tap](https://github.com/luciqai/homebrew-tap) repo:
+
+```bash
+bundle exec rake formula:bump   # writes to ../homebrew-tap, override with TAP_DIR
+```
+
+Open a pull request in the tap repo with the result: Homebrew users stay on
+the previous version until the bumped formula lands on its `main` branch.
+`brew livecheck luciq-cli` reports when the formula lags RubyGems.

data/lib/luciq/api/client.rb

@@ -9,18 +9,13 @@ require 'luciq/config'
 module Luciq
   module API
     class Client
-      SYMBOLS_FILES_PATH = '/api/sdk/v3/symbols_files'
-      SO_FILES_PATH = '/api/web/public/so_files'
-      FLUTTER_IOS_SYMBOLS_PATH = '/api/web/public/flutter-symbol-files/ios'
-      FLUTTER_ANDROID_SYMBOLS_PATH = '/api/web/public/flutter-symbol-files/android'
-
       def initialize
         @token = Config.load_token
         @base_url = Config.load_base_url
       end
 
       def whoami
-        uri = build_uri('/api/web/public/cli/whoami')
+        uri = build_uri('/api/cli/whoami')
         request = Net::HTTP::Get.new(uri)
         apply_headers(request)
         execute(uri, request)
@@ -37,145 +32,17 @@ module Luciq
         execute(uri, request)
       end
 
-      def upload_ios_dsym(file_path:, app_token:)
-        upload_dsym(file_path: file_path, app_token: app_token)
-      end
-
-      def upload_android_mapping(file_path:, app_token:, version_code:, version_name:)
-        upload_mapping(
-          file_path: file_path, app_token: app_token,
-          version_code: version_code, version_name: version_name
-        )
-      end
-
-      def upload_android_ndk(file_path:, app_token:, app_version:, arch:)
-        upload_so_file(file_path: file_path, app_token: app_token, app_version: app_version, arch: arch)
-      end
-
-      def upload_react_native_ios_dsym(file_path:, app_token:)
-        upload_dsym(file_path: file_path, app_token: app_token)
-      end
-
-      def upload_react_native_ios_sourcemap(file_path:, app_token:, app_version:)
-        upload_react_native_sourcemap(
-          file_path: file_path, app_token: app_token, os: 'ios', app_version: app_version
-        )
-      end
-
-      def upload_react_native_android_mapping(file_path:, app_token:, version_code:, version_name:)
-        upload_mapping(
-          file_path: file_path, app_token: app_token,
-          version_code: version_code, version_name: version_name
-        )
-      end
-
-      def upload_react_native_android_sourcemap(file_path:, app_token:, app_version:)
-        upload_react_native_sourcemap(
-          file_path: file_path, app_token: app_token, os: 'android', app_version: app_version
-        )
-      end
-
-      def upload_react_native_ndk(file_path:, app_token:, app_version:, arch:)
-        upload_so_file(file_path: file_path, app_token: app_token, app_version: app_version, arch: arch)
-      end
-
-      def upload_flutter_ios_dsym(file_path:, app_token:)
-        upload_dsym(file_path: file_path, app_token: app_token)
-      end
-
-      def upload_flutter_ios_sourcemap(file_path:, app_token:, version_name:, version_code:)
-        upload_flutter_symbols(
-          FLUTTER_IOS_SYMBOLS_PATH,
-          file_path: file_path, app_token: app_token,
-          version_name: version_name, version_code: version_code
-        )
-      end
-
-      def upload_flutter_android_mapping(file_path:, app_token:, version_code:, version_name:)
-        upload_mapping(
-          file_path: file_path, app_token: app_token,
-          version_code: version_code, version_name: version_name
-        )
-      end
-
-      def upload_flutter_android_sourcemap(file_path:, app_token:, version_name:, version_code:)
-        upload_flutter_symbols(
-          FLUTTER_ANDROID_SYMBOLS_PATH,
-          file_path: file_path, app_token: app_token,
-          version_name: version_name, version_code: version_code
-        )
-      end
-
-      def upload_flutter_ndk(file_path:, app_token:, app_version:, arch:)
-        upload_so_file(file_path: file_path, app_token: app_token, app_version: app_version, arch: arch)
-      end
-
-      private
-
-      def upload_dsym(file_path:, app_token:)
-        uri = build_uri(SYMBOLS_FILES_PATH)
-        File.open(file_path, 'rb') do |file|
-          params = {
-            'symbols_file' => UploadIO.new(file, 'application/octet-stream', File.basename(file_path)),
-            'application_token' => app_token,
-            'os' => 'ios'
-          }
-          post_multipart(uri, params)
-        end
-      end
-
-      def upload_mapping(file_path:, app_token:, version_code:, version_name:)
-        uri = build_uri(SYMBOLS_FILES_PATH)
-        File.open(file_path, 'rb') do |file|
-          params = {
-            'symbols_file' => UploadIO.new(file, 'application/octet-stream', File.basename(file_path)),
-            'application_token' => app_token,
-            'os' => 'android',
-            'app_version' => { code: version_code, name: version_name }.to_json
-          }
-          post_multipart(uri, params)
-        end
-      end
-
-      def upload_react_native_sourcemap(file_path:, app_token:, os:, app_version:)
-        uri = build_uri(SYMBOLS_FILES_PATH)
+      def upload(command, file_path, fields = {})
+        uri = build_uri("/api/cli/uploads/#{command}")
         File.open(file_path, 'rb') do |file|
           params = {
-            'symbols_file' => UploadIO.new(file, source_map_content_type(file_path), File.basename(file_path)),
-            'application_token' => app_token,
-            'platform' => 'react_native',
-            'os' => os,
-            'app_version' => app_version.to_json
-          }
+            'file' => UploadIO.new(file, content_type_for(file_path), File.basename(file_path))
+          }.merge(fields)
           post_multipart(uri, params)
         end
       end
 
-      def upload_so_file(file_path:, app_token:, app_version:, arch:)
-        uri = build_uri(SO_FILES_PATH)
-        File.open(file_path, 'rb') do |file|
-          params = {
-            'so_file' => UploadIO.new(file, 'application/octet-stream', File.basename(file_path)),
-            'application_token' => app_token,
-            'app_version' => app_version,
-            'arch' => arch
-          }
-          post_multipart(uri, params)
-        end
-      end
-
-      def upload_flutter_symbols(path, file_path:, app_token:, version_name:, version_code:)
-        uri = build_uri(path)
-        File.open(file_path, 'rb') do |file|
-          params = {
-            'file' => UploadIO.new(file, 'application/octet-stream', File.basename(file_path)),
-            'application_token' => app_token,
-            'app_version_name' => version_name,
-            'app_version_code' => version_code
-          }
-          post_multipart(uri, params)
-        end
-      end
+      private
 
       def post_multipart(uri, params)
         request = Net::HTTP::Post::Multipart.new(uri.path, params)
@@ -183,8 +50,12 @@ module Luciq
         execute(uri, request)
       end
 
-      def source_map_content_type(file_path)
-        file_path.downcase.end_with?('.json') ? 'application/json' : 'text/plain'
+      def content_type_for(file_path)
+        case File.extname(file_path).downcase
+        when '.json' then 'application/json'
+        when '.txt' then 'text/plain'
+        else 'application/octet-stream'
+        end
       end
 
       def build_uri(path)

data/lib/luciq/cli.rb

@@ -15,7 +15,7 @@ module Luciq
     desc 'login', 'Authenticate with Luciq'
     long_desc <<~DESC
       Authenticate with Luciq using a CLI token.
-      Generate a CLI token from your Luciq dashboard: https://dashboard.luciq.ai/company/cli
+      Generate a CLI token from your Luciq dashboard: https://dashboard.luciq.ai/company/luciq-cli
       The token will be saved in ~/.luciqrc
     DESC
     option :auth_token, type: :string, desc: 'CLI authentication token'

data/lib/luciq/commands/auth.rb

@@ -16,7 +16,7 @@ module Luciq
         unless token
           puts 'Login to Luciq'
           puts '=' * 40
-          puts 'Generate a CLI token from your Luciq dashboard: https://dashboard.luciq.ai/company/cli'
+          puts 'Generate a CLI token from your Luciq dashboard: https://dashboard.luciq.ai/company/luciq-cli'
           puts
           puts "Note: For self-hosted clusters, replace 'dashboard' with your cluster name."
           puts

data/lib/luciq/commands/query_arguments.rb

@@ -101,6 +101,9 @@ module Luciq
         if action && (@options[:status] || @options[:priority])
           raise 'Duplicate marking cannot be combined with --status/--priority'
         end
+        if @options[:clear_tags] && @options[:tag_action]
+          raise '--clear-tags cannot be combined with --tag-action (--clear-tags already replaces with an empty set)'
+        end
 
         changes = {
           status_id: map_one(BUG_STATUS_IDS, @options[:status]),
@@ -109,9 +112,19 @@ module Luciq
           action: action,
           original_bug_number: @options[:duplicate_of]
         }.compact
-        return changes unless changes.empty?
 
-        raise 'Provide at least one change (--status/--priority/--tags/--clear-tags/--duplicate-of/--action)'
+        if changes.empty?
+          raise 'Provide at least one change (--status/--priority/--tags/--clear-tags/--duplicate-of/--action)'
+        end
+
+        # tag_action only modifies how --tags is applied; on its own it is not a change
+        if @options[:clear_tags]
+          changes[:tag_action] = 'replace'
+        elsif @options[:tag_action]
+          changes[:tag_action] = @options[:tag_action]
+        end
+
+        changes
       end
 
       def bug_duplicate_action

data/lib/luciq/commands/upload.rb

@@ -13,144 +13,68 @@ module Luciq
       end
 
       def ios_dsym(file_path)
-        run_upload(file_path, 'iOS dSYM file', format: :zip) do
-          @client.upload_ios_dsym(file_path: file_path, app_token: @options[:app_token])
-        end
+        run_upload('ios-dsym', file_path, 'iOS dSYM file', format: :zip)
       end
 
       def android_mapping(file_path)
-        run_upload(file_path, 'Android mapping file') do
-          @client.upload_android_mapping(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            version_code: @options[:version_code],
-            version_name: @options[:version_name]
-          )
-        end
+        run_upload('android-mapping', file_path, 'Android mapping file')
       end
 
       def android_ndk(file_path)
-        run_upload(file_path, 'Android NDK .so files', format: :zip) do
-          validate_arch!
-          @client.upload_android_ndk(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            app_version: @options[:version_name],
-            arch: @options[:arch]
-          )
-        end
+        run_upload('android-ndk', file_path, 'Android NDK .so files', format: :zip, arch: true)
       end
 
       def react_native_ios_dsym(file_path)
-        run_upload(file_path, 'React Native iOS dSYM', format: :zip) do
-          @client.upload_react_native_ios_dsym(file_path: file_path, app_token: @options[:app_token])
-        end
+        run_upload('react-native-ios-dsym', file_path, 'React Native iOS dSYM', format: :zip)
       end
 
       def react_native_ios_sourcemap(file_path)
-        run_upload(file_path, 'React Native iOS source map', format: :sourcemap) do
-          @client.upload_react_native_ios_sourcemap(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            app_version: build_app_version
-          )
-        end
+        run_upload('react-native-ios-sourcemap', file_path, 'React Native iOS source map', format: :sourcemap)
       end
 
       def react_native_android_mapping(file_path)
-        run_upload(file_path, 'React Native Android mapping file') do
-          @client.upload_react_native_android_mapping(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            version_code: @options[:version_code],
-            version_name: @options[:version_name]
-          )
-        end
+        run_upload('react-native-android-mapping', file_path, 'React Native Android mapping file')
       end
 
       def react_native_android_sourcemap(file_path)
-        run_upload(file_path, 'React Native Android source map', format: :sourcemap) do
-          @client.upload_react_native_android_sourcemap(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            app_version: build_app_version
-          )
-        end
+        run_upload('react-native-android-sourcemap', file_path, 'React Native Android source map', format: :sourcemap)
       end
 
       def react_native_ndk(file_path)
-        run_upload(file_path, 'React Native NDK .so files', format: :zip) do
-          validate_arch!
-          @client.upload_react_native_ndk(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            app_version: @options[:version_name],
-            arch: @options[:arch]
-          )
-        end
+        run_upload('react-native-ndk', file_path, 'React Native NDK .so files', format: :zip, arch: true)
       end
 
       def flutter_ios_dsym(file_path)
-        run_upload(file_path, 'Flutter iOS dSYM', format: :zip) do
-          @client.upload_flutter_ios_dsym(file_path: file_path, app_token: @options[:app_token])
-        end
+        run_upload('flutter-ios-dsym', file_path, 'Flutter iOS dSYM', format: :zip)
       end
 
       def flutter_ios_sourcemap(file_path)
-        run_upload(file_path, 'Flutter iOS Dart sourcemap', format: :zip) do
-          @client.upload_flutter_ios_sourcemap(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            version_name: @options[:version_name],
-            version_code: @options[:version_code]
-          )
-        end
+        run_upload('flutter-ios-sourcemap', file_path, 'Flutter iOS Dart sourcemap', format: :zip)
       end
 
       def flutter_android_mapping(file_path)
-        run_upload(file_path, 'Flutter Android mapping file') do
-          @client.upload_flutter_android_mapping(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            version_code: @options[:version_code],
-            version_name: @options[:version_name]
-          )
-        end
+        run_upload('flutter-android-mapping', file_path, 'Flutter Android mapping file')
       end
 
       def flutter_android_sourcemap(file_path)
-        run_upload(file_path, 'Flutter Android Dart sourcemap', format: :zip) do
-          @client.upload_flutter_android_sourcemap(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            version_name: @options[:version_name],
-            version_code: @options[:version_code]
-          )
-        end
+        run_upload('flutter-android-sourcemap', file_path, 'Flutter Android Dart sourcemap', format: :zip)
       end
 
       def flutter_ndk(file_path)
-        run_upload(file_path, 'Flutter NDK .so files', format: :zip) do
-          validate_arch!
-          @client.upload_flutter_ndk(
-            file_path: file_path,
-            app_token: @options[:app_token],
-            app_version: @options[:version_name],
-            arch: @options[:arch]
-          )
-        end
+        run_upload('flutter-ndk', file_path, 'Flutter NDK .so files', format: :zip, arch: true)
       end
 
       private
 
-      def run_upload(file_path, label, format: nil)
+      def run_upload(command, file_path, label, format: nil, arch: false)
         validate_file!(file_path)
         validate_format!(file_path, format)
+        validate_arch! if arch
 
         puts "Uploading #{label}: #{File.basename(file_path)}"
         puts
 
-        yield
+        @client.upload(command, file_path, @options)
 
         puts "✓ #{label} uploaded successfully!"
       rescue StandardError => e
@@ -198,14 +122,6 @@ module Luciq
         puts "  Allowed values: #{ALLOWED_ARCHITECTURES.join(', ')}"
         exit 1
       end
-
-      def build_app_version
-        {
-          code: @options[:version_code],
-          name: @options[:version_name],
-          codepush: @options[:codepush]
-        }.compact
-      end
     end
   end
 end

data/lib/luciq/query_cli.rb

@@ -199,6 +199,10 @@ module Luciq
       Update a bug. Provide at least one change: --status/--priority/--tags/--clear-tags
       change the bug; duplicate marking is a separate action and can't be combined with them.
 
+      Tags: --tags appends to the existing tags by default. Use --tag-action to change
+      that: replace sets --tags as the full list (removing others); remove deletes --tags
+      and keeps the rest. --clear-tags removes all tags.
+
       Mark a duplicate: --duplicate-of <master-number> (implies --action mark_as_duplicate).
       Detach a duplicate: --action unmark_as_duplicate.
     DESC
@@ -206,8 +210,10 @@ module Luciq
     option :number, type: :numeric, required: true, desc: 'Bug number'
     option :status, type: :string, enum: %w[new closed in_progress], desc: 'New status'
     option :priority, type: :string, enum: %w[na trivial minor major blocker], desc: 'New priority'
-    option :tags, type: :array, desc: 'Tags to set (replaces all existing tags)'
-    option :clear_tags, type: :boolean, desc: 'Remove all tags'
+    option :tags, type: :array, desc: 'Tags to apply (see --tag-action; appends to existing tags by default)'
+    option :tag_action, type: :string, enum: %w[replace append remove],
+                        desc: 'How --tags is applied: append (default, keep existing), replace, remove'
+    option :clear_tags, type: :boolean, desc: 'Remove all tags (cannot be combined with --tag-action)'
     option :duplicate_of, type: :numeric, desc: 'Master bug number (marks this a duplicate)'
     option :action, type: :string, enum: %w[mark_as_duplicate unmark_as_duplicate],
                     desc: 'Duplicate action (defaults to mark_as_duplicate with --duplicate-of)'

data/lib/luciq/upload_cli.rb

@@ -2,6 +2,7 @@
 
 require 'thor'
 require 'luciq/commands/upload'
+require 'luciq/query_cli'
 
 module Luciq
   class UploadCLI < Thor
@@ -12,9 +13,9 @@ module Luciq
       Upload iOS dSYM files to Luciq for crash symbolication.
       File format: .zip containing dSYM files
       Example:
-        luciq upload ios-dsym MyApp.dSYM.zip --app-token APP_TOKEN
+        luciq upload ios-dsym MyApp.dSYM.zip --slug my-app --mode production
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your Luciq application token'
+    QueryOptions.app(self)
     def ios_dsym(file)
       Commands::Upload.new(options).ios_dsym(file)
     end
@@ -24,9 +25,9 @@ module Luciq
       Upload Android Proguard/R8 mapping files to Luciq for crash deobfuscation.
       File format: mapping.txt
       Example:
-        luciq upload android-mapping mapping.txt --app-token APP_TOKEN --version-name 1.0.0 --version-code 1
+        luciq upload android-mapping mapping.txt --slug my-app --mode production --version-name 1.0.0 --version-code 1
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your Luciq application token'
+    QueryOptions.app(self)
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     option :version_code, type: :string, required: true, desc: 'App version code (e.g., 1)'
     def android_mapping(file)
@@ -38,9 +39,9 @@ module Luciq
       Upload Android NDK shared object (.so) files to Luciq for native crash symbolication.
       File format: .zip containing the .so files
       Example:
-        luciq upload android-ndk so-files.zip --app-token APP_TOKEN --version-name 1.0.0 --arch arm64-v8a
+        luciq upload android-ndk so-files.zip --slug my-app --mode production --version-name 1.0.0 --arch arm64-v8a
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your Luciq application token'
+    QueryOptions.app(self)
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     option :arch, type: :string, required: true, enum: ARCHITECTURES, desc: 'CPU architecture'
     def android_ndk(file)
@@ -52,9 +53,9 @@ module Luciq
       Upload React Native iOS dSYM files to Luciq for native crash symbolication.
       File format: .zip containing dSYM files
       Example:
-        luciq upload react-native-ios-dsym dsyms.zip --app-token APP_TOKEN
+        luciq upload react-native-ios-dsym dsyms.zip --slug my-app --mode production
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your application token'
+    QueryOptions.app(self)
     def react_native_ios_dsym(file)
       Commands::Upload.new(options).react_native_ios_dsym(file)
     end
@@ -64,9 +65,9 @@ module Luciq
       Upload React Native iOS JavaScript source maps to Luciq for crash symbolication.
       File format: .json or .txt source map
       Example:
-        luciq upload react-native-ios-sourcemap ios-sourcemap.json --app-token APP_TOKEN --version-code 1 --version-name 1.0.0
+        luciq upload react-native-ios-sourcemap ios-sourcemap.json --slug my-app --mode production --version-code 1 --version-name 1.0.0
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your application token'
+    QueryOptions.app(self)
     option :version_code, type: :string, required: true, desc: 'App version code (e.g., 1)'
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     option :codepush, type: :string, desc: 'CodePush version label (e.g., v42)'
@@ -79,9 +80,9 @@ module Luciq
       Upload React Native Android Proguard/R8 mapping files to Luciq for native crash deobfuscation.
       File format: mapping.txt
       Example:
-        luciq upload react-native-android-mapping mapping.txt --app-token APP_TOKEN --version-code 1 --version-name 1.0.0
+        luciq upload react-native-android-mapping mapping.txt --slug my-app --mode production --version-code 1 --version-name 1.0.0
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your application token'
+    QueryOptions.app(self)
     option :version_code, type: :string, required: true, desc: 'App version code (e.g., 1)'
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     def react_native_android_mapping(file)
@@ -93,9 +94,9 @@ module Luciq
       Upload React Native Android JavaScript source maps to Luciq for crash deobfuscation.
       File format: .json or .txt source map
       Example:
-        luciq upload react-native-android-sourcemap android-sourcemap.json --app-token APP_TOKEN --version-code 1 --version-name 1.0.0
+        luciq upload react-native-android-sourcemap android-sourcemap.json --slug my-app --mode production --version-code 1 --version-name 1.0.0
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your application token'
+    QueryOptions.app(self)
     option :version_code, type: :string, required: true, desc: 'App version code (e.g., 1)'
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     option :codepush, type: :string, desc: 'CodePush version label (e.g., v42)'
@@ -108,9 +109,9 @@ module Luciq
       Upload React Native NDK shared object (.so) files to Luciq for native crash symbolication.
       File format: .zip containing the .so files
       Example:
-        luciq upload react-native-ndk so-files.zip --app-token APP_TOKEN --version-name 1.0.0 --arch arm64-v8a
+        luciq upload react-native-ndk so-files.zip --slug my-app --mode production --version-name 1.0.0 --arch arm64-v8a
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your application token'
+    QueryOptions.app(self)
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     option :arch, type: :string, required: true, enum: ARCHITECTURES, desc: 'CPU architecture'
     def react_native_ndk(file)
@@ -122,9 +123,9 @@ module Luciq
       Upload Flutter iOS dSYM files to Luciq for native crash symbolication.
       File format: .zip containing dSYM files
       Example:
-        luciq upload flutter-ios-dsym MyApp.dSYM.zip --app-token APP_TOKEN
+        luciq upload flutter-ios-dsym MyApp.dSYM.zip --slug my-app --mode production
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your Luciq application token'
+    QueryOptions.app(self)
     def flutter_ios_dsym(file)
       Commands::Upload.new(options).flutter_ios_dsym(file)
     end
@@ -134,9 +135,9 @@ module Luciq
       Upload Flutter iOS Dart sourcemap files to Luciq for crash symbolication.
       File format: .zip containing Flutter debug symbols
       Example:
-        luciq upload flutter-ios-sourcemap app.ios-arm64.symbols.zip --app-token APP_TOKEN --version-name 1.0.0 --version-code 1
+        luciq upload flutter-ios-sourcemap app.ios-arm64.symbols.zip --slug my-app --mode production --version-name 1.0.0 --version-code 1
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your Luciq application token'
+    QueryOptions.app(self)
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     option :version_code, type: :string, required: true, desc: 'App version code (e.g., 1)'
     def flutter_ios_sourcemap(file)
@@ -148,9 +149,9 @@ module Luciq
       Upload Flutter Android Proguard/R8 mapping files to Luciq for native crash deobfuscation.
       File format: mapping.txt
       Example:
-        luciq upload flutter-android-mapping mapping.txt --app-token APP_TOKEN --version-code 1 --version-name 1.0.0
+        luciq upload flutter-android-mapping mapping.txt --slug my-app --mode production --version-code 1 --version-name 1.0.0
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your Luciq application token'
+    QueryOptions.app(self)
     option :version_code, type: :string, required: true, desc: 'App version code (e.g., 1)'
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     def flutter_android_mapping(file)
@@ -162,9 +163,9 @@ module Luciq
       Upload Flutter Android Dart sourcemap files to Luciq for crash symbolication.
       File format: .zip containing Flutter debug symbols
       Example:
-        luciq upload flutter-android-sourcemap app.android-arm64.symbols.zip --app-token APP_TOKEN --version-name 1.0.0 --version-code 1
+        luciq upload flutter-android-sourcemap app.android-arm64.symbols.zip --slug my-app --mode production --version-name 1.0.0 --version-code 1
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your Luciq application token'
+    QueryOptions.app(self)
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     option :version_code, type: :string, required: true, desc: 'App version code (e.g., 1)'
     def flutter_android_sourcemap(file)
@@ -176,9 +177,9 @@ module Luciq
       Upload Flutter NDK shared object (.so) files to Luciq for native crash symbolication.
       File format: .zip containing the .so files
       Example:
-        luciq upload flutter-ndk so-files.zip --app-token APP_TOKEN --version-name 1.0.0 --arch arm64-v8a
+        luciq upload flutter-ndk so-files.zip --slug my-app --mode production --version-name 1.0.0 --arch arm64-v8a
     DESC
-    option :app_token, type: :string, required: true, desc: 'Your Luciq application token'
+    QueryOptions.app(self)
     option :version_name, type: :string, required: true, desc: 'App version name (e.g., 1.0.0)'
     option :arch, type: :string, required: true, enum: ARCHITECTURES, desc: 'CPU architecture'
     def flutter_ndk(file)

data/lib/luciq/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Luciq
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: luciq-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ahmed Hany
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-06 00:00:00.000000000 Z
+date: 2026-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multipart-post
@@ -47,6 +47,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
+- LICENSE
 - README.md
 - bin/luciq
 - lib/luciq/api/client.rb
@@ -59,13 +60,13 @@ files:
 - lib/luciq/query_cli.rb
 - lib/luciq/upload_cli.rb
 - lib/luciq/version.rb
-homepage: https://github.com/Instabug/luciq-cli
+homepage: https://github.com/luciqai/luciq-cli
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/Instabug/luciq-cli
-  source_code_uri: https://github.com/Instabug/luciq-cli
-  changelog_uri: https://github.com/Instabug/luciq-cli/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/luciqai/luciq-cli
+  source_code_uri: https://github.com/luciqai/luciq-cli
+  changelog_uri: https://github.com/luciqai/luciq-cli/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []