fizzy-cli 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c7249d6d732c7829bdb9e165d6b5972995952c92771d59ca80f7335a95b2af8
-  data.tar.gz: 0436f2a6c63316375ffa19488f2d1b4ecef6fc1066fd1422ccad3124069b1585
+  metadata.gz: e138fc3dd09193bc96ddc984ec1a4c68c5d425ab1522f90633cb8013741dcab2
+  data.tar.gz: ad8e75db7233f1fb6fb6aed72713c0a7876bc5cc94f0e39644b18562e02f3c97
 SHA512:
-  metadata.gz: bec62220f8d21d6edceab3a0d1dc7835ca5cb5c1f0f404d5923cf3eed3eef0c4330798e8dab644c3bafe88d70e3e8c2c747398d5742baa90311684aaa323afe9
-  data.tar.gz: 0d106800ad06848b59ec24fe0bcb0a6802f71f131a0890698ef133ce6c2276d927e7922473d759958c4554905725fa975abc72cfcb58e43f8583952e08800297
+  metadata.gz: f9fc0ed67b2f598b0959ba808b1b0b992430f2aba7c1e98f5b29aeb757351575e3700da8864943f385f2ffcd9be3795229cfdbb57a4bea963768559eacd1aac7
+  data.tar.gz: 4e3d6af1559e5994c1431b1a5681c806c8a3661cf8de8d0e84dbca5f44c7f1df598a4bac10238dada7f05267f48bfbc264ff6f526a8ac2eb4c0f49a5eed514d9

data/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.3.2] - 2026-02-22
+
+### Changed
+- Moved AI Agent Skill section in README to immediately follow Install
+
+## [0.3.1] - 2026-02-22
+
+### Changed
+- Client auto-prepends account slug to API paths; CLI subcommands pass relative paths instead of manually building `/slug/resource` strings
+- Removed `slug` helper from CLI::Base and `account_slug` accessor from Client
+
 ## [0.3.0] - 2026-02-22
 
 ### Added

data/README.md

@@ -13,6 +13,18 @@ Requires Ruby >= 3.2.
 gem install fizzy
 ```
 
+### AI Agent Skill
+
+Fizzy CLI ships with a [skill file](skills/fizzy-cli/SKILL.md) that teaches AI coding assistants (Claude Code, Codex) how to use the CLI. Install it so agents can manage your Fizzy boards and cards autonomously.
+
+```sh
+fizzy skill install                          # Claude Code, user-level (default)
+fizzy skill install --target codex           # OpenAI Codex / OpenCode
+fizzy skill install --target all             # All supported agents
+fizzy skill install --scope project          # Project-level instead of user-level
+fizzy skill uninstall                        # Remove skill file
+```
+
 ## Authentication
 
 ### Getting a Personal Access Token
@@ -190,26 +202,6 @@ bundle exec rake test   # tests only
 bundle exec rubocop     # lint only
 ```
 
-## AI Agent Integration
-
-Fizzy CLI ships with a [skill file](skills/fizzy-cli/SKILL.md) that teaches AI coding assistants how to use the CLI. Install it so agents can manage your Fizzy boards and cards autonomously.
-
-The `fizzy` gem must be installed and authenticated first:
-
-```sh
-gem install fizzy-cli
-fizzy auth login --token YOUR_TOKEN
-```
-
-```sh
-fizzy skill install                          # Claude Code, user-level (default)
-fizzy skill install --target codex           # OpenAI Codex / OpenCode
-fizzy skill install --target all             # All supported agents
-fizzy skill install --scope project          # Project-level instead of user-level
-fizzy skill uninstall                        # Remove skill file
-```
-
-
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/dpaluy/fizzy-cli.

data/lib/fizzy/cli/base.rb

@@ -28,10 +28,6 @@ module Fizzy
         )
       end
 
-      def slug
-        "/#{client.account_slug}"
-      end
-
       def paginator
         @paginator ||= Paginator.new(client)
       end

data/lib/fizzy/cli/boards.rb

@@ -7,7 +7,7 @@ module Fizzy
 
       desc "list", "List all boards"
       def list
-        data = paginator.all("#{slug}/boards")
+        data = paginator.all("boards")
         output_list(data, headers: %w[ID Name Cards Columns]) do |b|
           [b["id"], b["name"], b["open_cards_count"], b["columns_count"]]
         end
@@ -15,7 +15,7 @@ module Fizzy
 
       desc "get BOARD_ID", "Show a board"
       def get(board_id)
-        resp = client.get("#{slug}/boards/#{board_id}")
+        resp = client.get("boards/#{board_id}")
         b = resp.body
         output_detail(b, pairs: [
                         ["ID", b["id"]],
@@ -28,7 +28,7 @@ module Fizzy
 
       desc "create NAME", "Create a board"
       def create(name)
-        resp = client.post("#{slug}/boards", body: { name: name })
+        resp = client.post("boards", body: { name: name })
         b = resp.body
         output_detail(b, pairs: [
                         ["ID", b["id"]],
@@ -39,7 +39,7 @@ module Fizzy
       desc "update BOARD_ID", "Update a board"
       option :name, required: true, desc: "New board name"
       def update(board_id)
-        resp = client.put("#{slug}/boards/#{board_id}", body: { name: options[:name] })
+        resp = client.put("boards/#{board_id}", body: { name: options[:name] })
         b = resp.body
         output_detail(b, pairs: [
                         ["ID", b["id"]],
@@ -49,7 +49,7 @@ module Fizzy
 
       desc "delete BOARD_ID", "Delete a board"
       def delete(board_id)
-        client.delete("#{slug}/boards/#{board_id}")
+        client.delete("boards/#{board_id}")
         puts "Board #{board_id} deleted."
       end
     end

data/lib/fizzy/cli/cards.rb

@@ -19,7 +19,7 @@ module Fizzy
         params[:assignee_id] = options[:assignee] if options[:assignee]
         options[:tag]&.each { |t| (params[:"tag_ids[]"] ||= []) << t }
 
-        data = paginator.all("#{slug}/cards", params: params)
+        data = paginator.all("cards", params: params)
         output_list(data, headers: %w[# Title Board Status Column]) do |c|
           [
             c["number"],
@@ -33,7 +33,7 @@ module Fizzy
 
       desc "get NUMBER", "Show a card"
       def get(number)
-        resp = client.get("#{slug}/cards/#{number}")
+        resp = client.get("cards/#{number}")
         c = resp.body
         output_detail(c, pairs: [
                         ["Number", "##{c["number"]}"],
@@ -58,7 +58,7 @@ module Fizzy
         body = { title: title }
         body[:body] = options[:body] if options[:body]
         body[:column_id] = options[:column] if options[:column]
-        resp = client.post("#{slug}/boards/#{options[:board]}/cards", body: body)
+        resp = client.post("boards/#{options[:board]}/cards", body: body)
         c = resp.body
         output_detail(c, pairs: [
                         ["Number", "##{c["number"]}"],
@@ -71,7 +71,7 @@ module Fizzy
       option :title, desc: "New title"
       option :body, desc: "New body (HTML)"
       def update(number)
-        resp = client.put("#{slug}/cards/#{number}", body: build_body(:title, :body))
+        resp = client.put("cards/#{number}", body: build_body(:title, :body))
         c = resp.body
         output_detail(c, pairs: [
                         ["Number", "##{c["number"]}"],
@@ -81,75 +81,75 @@ module Fizzy
 
       desc "delete NUMBER", "Delete a card"
       def delete(number)
-        client.delete("#{slug}/cards/#{number}")
+        client.delete("cards/#{number}")
         puts "Card ##{number} deleted."
       end
 
       desc "close NUMBER", "Close a card"
       def close(number)
-        client.post("#{slug}/cards/#{number}/closure")
+        client.post("cards/#{number}/closure")
         puts "Card ##{number} closed."
       end
 
       desc "reopen NUMBER", "Reopen a closed card"
       def reopen(number)
-        client.delete("#{slug}/cards/#{number}/closure")
+        client.delete("cards/#{number}/closure")
         puts "Card ##{number} reopened."
       end
 
       desc "not-now NUMBER", "Mark a card as not-now"
       map "not-now" => :not_now
       def not_now(number)
-        client.post("#{slug}/cards/#{number}/not_now")
+        client.post("cards/#{number}/not_now")
         puts "Card ##{number} marked not-now."
       end
 
       desc "triage NUMBER", "Triage a card into a column"
       option :column, required: true, desc: "Column ID"
       def triage(number)
-        client.post("#{slug}/cards/#{number}/triage", body: { column_id: options[:column] })
+        client.post("cards/#{number}/triage", body: { column_id: options[:column] })
         puts "Card ##{number} triaged."
       end
 
       desc "untriage NUMBER", "Remove a card from triage"
       def untriage(number)
-        client.delete("#{slug}/cards/#{number}/triage")
+        client.delete("cards/#{number}/triage")
         puts "Card ##{number} untriaged."
       end
 
       desc "tag NUMBER TAG_TITLE", "Add a tag to a card"
       def tag(number, tag_title)
-        client.post("#{slug}/cards/#{number}/taggings", body: { tag_title: tag_title })
+        client.post("cards/#{number}/taggings", body: { tag_title: tag_title })
         puts "Tag '#{tag_title}' added to card ##{number}."
       end
 
       desc "assign NUMBER ASSIGNEE_ID", "Toggle assignment on a card"
       def assign(number, assignee_id)
-        client.post("#{slug}/cards/#{number}/assignments", body: { assignee_id: assignee_id })
+        client.post("cards/#{number}/assignments", body: { assignee_id: assignee_id })
         puts "Assignment toggled for card ##{number}."
       end
 
       desc "watch NUMBER", "Watch a card"
       def watch(number)
-        client.post("#{slug}/cards/#{number}/watch")
+        client.post("cards/#{number}/watch")
         puts "Watching card ##{number}."
       end
 
       desc "unwatch NUMBER", "Unwatch a card"
       def unwatch(number)
-        client.delete("#{slug}/cards/#{number}/watch")
+        client.delete("cards/#{number}/watch")
         puts "Unwatched card ##{number}."
       end
 
       desc "golden NUMBER", "Mark a card as golden"
       def golden(number)
-        client.post("#{slug}/cards/#{number}/goldness")
+        client.post("cards/#{number}/goldness")
         puts "Card ##{number} marked golden."
       end
 
       desc "ungolden NUMBER", "Remove golden from a card"
       def ungolden(number)
-        client.delete("#{slug}/cards/#{number}/goldness")
+        client.delete("cards/#{number}/goldness")
         puts "Card ##{number} ungolden."
       end
 

data/lib/fizzy/cli/columns.rb

@@ -8,7 +8,7 @@ module Fizzy
       desc "list", "List columns for a board"
       option :board, required: true, desc: "Board ID"
       def list
-        data = paginator.all("#{slug}/boards/#{options[:board]}/columns")
+        data = paginator.all("boards/#{options[:board]}/columns")
         output_list(data, headers: %w[ID Name Position]) do |c|
           [c["id"], c["name"], c["position"]]
         end
@@ -17,7 +17,7 @@ module Fizzy
       desc "get COLUMN_ID", "Show a column"
       option :board, required: true, desc: "Board ID"
       def get(column_id)
-        resp = client.get("#{slug}/boards/#{options[:board]}/columns/#{column_id}")
+        resp = client.get("boards/#{options[:board]}/columns/#{column_id}")
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -30,7 +30,7 @@ module Fizzy
       desc "create NAME", "Create a column"
       option :board, required: true, desc: "Board ID"
       def create(name)
-        resp = client.post("#{slug}/boards/#{options[:board]}/columns", body: { name: name })
+        resp = client.post("boards/#{options[:board]}/columns", body: { name: name })
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -42,7 +42,7 @@ module Fizzy
       option :board, required: true, desc: "Board ID"
       option :name, required: true, desc: "New column name"
       def update(column_id)
-        resp = client.put("#{slug}/boards/#{options[:board]}/columns/#{column_id}", body: { name: options[:name] })
+        resp = client.put("boards/#{options[:board]}/columns/#{column_id}", body: { name: options[:name] })
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -53,7 +53,7 @@ module Fizzy
       desc "delete COLUMN_ID", "Delete a column"
       option :board, required: true, desc: "Board ID"
       def delete(column_id)
-        client.delete("#{slug}/boards/#{options[:board]}/columns/#{column_id}")
+        client.delete("boards/#{options[:board]}/columns/#{column_id}")
         puts "Column #{column_id} deleted."
       end
     end

data/lib/fizzy/cli/comments.rb

@@ -8,7 +8,7 @@ module Fizzy
       desc "list", "List comments on a card"
       option :card, required: true, type: :numeric, desc: "Card number"
       def list
-        data = paginator.all("#{slug}/cards/#{options[:card]}/comments")
+        data = paginator.all("cards/#{options[:card]}/comments")
         output_list(data, headers: %w[ID Author Created]) do |c|
           [c["id"], c.dig("creator", "name"), c["created_at"]]
         end
@@ -17,7 +17,7 @@ module Fizzy
       desc "get COMMENT_ID", "Show a comment"
       option :card, required: true, type: :numeric, desc: "Card number"
       def get(comment_id)
-        resp = client.get("#{slug}/cards/#{options[:card]}/comments/#{comment_id}")
+        resp = client.get("cards/#{options[:card]}/comments/#{comment_id}")
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -30,7 +30,7 @@ module Fizzy
       desc "create BODY", "Add a comment to a card"
       option :card, required: true, type: :numeric, desc: "Card number"
       def create(body_text)
-        resp = client.post("#{slug}/cards/#{options[:card]}/comments", body: { body: body_text })
+        resp = client.post("cards/#{options[:card]}/comments", body: { body: body_text })
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -42,7 +42,7 @@ module Fizzy
       option :card, required: true, type: :numeric, desc: "Card number"
       option :body, required: true, desc: "New body"
       def update(comment_id)
-        resp = client.put("#{slug}/cards/#{options[:card]}/comments/#{comment_id}", body: build_body(:body))
+        resp = client.put("cards/#{options[:card]}/comments/#{comment_id}", body: build_body(:body))
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -53,7 +53,7 @@ module Fizzy
       desc "delete COMMENT_ID", "Delete a comment"
       option :card, required: true, type: :numeric, desc: "Card number"
       def delete(comment_id)
-        client.delete("#{slug}/cards/#{options[:card]}/comments/#{comment_id}")
+        client.delete("cards/#{options[:card]}/comments/#{comment_id}")
         puts "Comment #{comment_id} deleted."
       end
     end

data/lib/fizzy/cli/notifications.rb

@@ -7,7 +7,7 @@ module Fizzy
 
       desc "list", "List notifications"
       def list
-        data = paginator.all("#{slug}/notifications")
+        data = paginator.all("notifications")
         output_list(data, headers: %w[ID Type Card Read Created]) do |n|
           [
             n["id"],
@@ -21,20 +21,20 @@ module Fizzy
 
       desc "read ID", "Mark notification as read"
       def read(id)
-        client.post("#{slug}/notifications/#{id}/reading")
+        client.post("notifications/#{id}/reading")
         puts "Notification #{id} marked read."
       end
 
       desc "unread ID", "Mark notification as unread"
       def unread(id)
-        client.delete("#{slug}/notifications/#{id}/reading")
+        client.delete("notifications/#{id}/reading")
         puts "Notification #{id} marked unread."
       end
 
       desc "mark-all-read", "Mark all notifications as read"
       map "mark-all-read" => :mark_all_read
       def mark_all_read
-        client.post("#{slug}/notifications/bulk_reading")
+        client.post("notifications/bulk_reading")
         puts "All notifications marked read."
       end
     end

data/lib/fizzy/cli/pins.rb

@@ -16,13 +16,13 @@ module Fizzy
 
       desc "pin NUMBER", "Pin a card"
       def pin(number)
-        client.post("#{slug}/cards/#{number}/pin")
+        client.post("cards/#{number}/pin")
         puts "Card ##{number} pinned."
       end
 
       desc "unpin NUMBER", "Unpin a card"
       def unpin(number)
-        client.delete("#{slug}/cards/#{number}/pin")
+        client.delete("cards/#{number}/pin")
         puts "Card ##{number} unpinned."
       end
     end

data/lib/fizzy/cli/reactions.rb

@@ -41,7 +41,7 @@ module Fizzy
       private
 
       def reaction_path(card_number, comment_id = nil)
-        base = "#{slug}/cards/#{card_number}"
+        base = "cards/#{card_number}"
         comment_id ? "#{base}/comments/#{comment_id}/reactions" : "#{base}/reactions"
       end
     end

data/lib/fizzy/cli/steps.rb

@@ -8,7 +8,7 @@ module Fizzy
       desc "get STEP_ID", "Show a step"
       option :card, required: true, type: :numeric, desc: "Card number"
       def get(step_id)
-        resp = client.get("#{slug}/cards/#{options[:card]}/steps/#{step_id}")
+        resp = client.get("cards/#{options[:card]}/steps/#{step_id}")
         s = resp.body
         output_detail(s, pairs: [
                         ["ID", s["id"]],
@@ -21,7 +21,7 @@ module Fizzy
       desc "create DESCRIPTION", "Add a step to a card"
       option :card, required: true, type: :numeric, desc: "Card number"
       def create(description)
-        resp = client.post("#{slug}/cards/#{options[:card]}/steps", body: { description: description })
+        resp = client.post("cards/#{options[:card]}/steps", body: { description: description })
         s = resp.body
         output_detail(s, pairs: [
                         ["ID", s["id"]],
@@ -34,7 +34,7 @@ module Fizzy
       option :description, desc: "New description"
       option :completed, type: :boolean, desc: "Mark completed"
       def update(step_id)
-        path = "#{slug}/cards/#{options[:card]}/steps/#{step_id}"
+        path = "cards/#{options[:card]}/steps/#{step_id}"
         resp = client.put(path, body: build_body(:description, :completed))
         s = resp.body
         output_detail(s, pairs: [
@@ -47,7 +47,7 @@ module Fizzy
       desc "delete STEP_ID", "Delete a step"
       option :card, required: true, type: :numeric, desc: "Card number"
       def delete(step_id)
-        client.delete("#{slug}/cards/#{options[:card]}/steps/#{step_id}")
+        client.delete("cards/#{options[:card]}/steps/#{step_id}")
         puts "Step #{step_id} deleted."
       end
     end

data/lib/fizzy/cli/tags.rb

@@ -7,7 +7,7 @@ module Fizzy
 
       desc "list", "List all tags"
       def list
-        data = paginator.all("#{slug}/tags")
+        data = paginator.all("tags")
         output_list(data, headers: %w[ID Title Color]) do |t|
           [t["id"], t["title"] || t["name"], t["color"]]
         end

data/lib/fizzy/cli/users.rb

@@ -7,7 +7,7 @@ module Fizzy
 
       desc "list", "List users"
       def list
-        data = paginator.all("#{slug}/users")
+        data = paginator.all("users")
         output_list(data, headers: %w[ID Name Email Role Active]) do |u|
           [u["id"], u["name"], u["email_address"], u["role"], u["active"]]
         end
@@ -15,7 +15,7 @@ module Fizzy
 
       desc "get USER_ID", "Show a user"
       def get(user_id)
-        resp = client.get("#{slug}/users/#{user_id}")
+        resp = client.get("users/#{user_id}")
         u = resp.body
         output_detail(u, pairs: [
                         ["ID", u["id"]],
@@ -31,7 +31,7 @@ module Fizzy
       option :name, desc: "New name"
       option :role, desc: "New role"
       def update(user_id)
-        resp = client.put("#{slug}/users/#{user_id}", body: build_body(:name, :role))
+        resp = client.put("users/#{user_id}", body: build_body(:name, :role))
         u = resp.body
         output_detail(u, pairs: [
                         ["ID", u["id"]],
@@ -42,7 +42,7 @@ module Fizzy
 
       desc "deactivate USER_ID", "Deactivate a user"
       def deactivate(user_id)
-        client.delete("#{slug}/users/#{user_id}")
+        client.delete("users/#{user_id}")
         puts "User #{user_id} deactivated."
       end
     end

data/lib/fizzy/client.rb

@@ -6,8 +6,6 @@ module Fizzy
   class Client
     BASE_URL = "https://app.fizzy.do"
 
-    attr_reader :account_slug
-
     def initialize(token:, account_slug:)
       @token = token
       @account_slug = account_slug
@@ -49,7 +47,8 @@ module Fizzy
     end
 
     def request(method, path, body: nil, params: {})
-      uri = URI("#{BASE_URL}#{path}")
+      full_path = path.start_with?("/") ? path : "/#{@account_slug}/#{path}"
+      uri = URI("#{BASE_URL}#{full_path}")
       uri.query = URI.encode_www_form(params) unless params.empty?
 
       req = build_request(method, uri)

data/lib/fizzy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fizzy
-  VERSION = "0.3.0"
+  VERSION = "0.3.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fizzy-cli
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - David Paluy