fizzy-cli 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a799ac974669e5becb4d5bd617a4158be7878e36a432014b4c9b1cba9823b92b
-  data.tar.gz: 4d14b732076b82dd8e0d26102da3db311a6ff14d38707f055e17264012949e53
+  metadata.gz: ca34b7cb72db62ab1659d5210eb4463496870cf817c88fa58321e7443a630ad3
+  data.tar.gz: 8d653993a4bb9bc85079f2b16c1f0c84d496abaab50c15c6ed5e9443fd16b089
 SHA512:
-  metadata.gz: bc9f814d55706dab9762776cccd10492cc0087c0c3152ab968701e98e87812714a52dfa0e9c79eccb3133e7288762f5a081a63c07b8d829f848a85f37606c4d9
-  data.tar.gz: fff7b7a0f5435d848a8b0c87a82f7f2eaa92d586dc4359f5c8711fd890a7b3f3ed5dc597e326017612cd944f264a076d436f30116df669632b46399921c93532
+  metadata.gz: 1152c52e0574fc5b9cb4f499de24e3cceaf046d2cdddc4f6a20f8d2eac1def18ebec9adf36be0f7f0aa61acbdcc24ef6b7353b04e0ecc61a58faba907b0157ec
+  data.tar.gz: 0a64fd82e2b22f214cf73a1770f3a373cc461986f521485311d27c8914d4d0948c6be68ae91252f103d27655f4f59dccc6b35adf47491d024bdaafd9e57df2e2

data/CHANGELOG.md

@@ -5,6 +5,29 @@ 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.4.0] - 2026-02-22
+
+### Added
+- Per-project `.fizzy.yml` config file for account and board defaults
+- `fizzy init` interactive command to create `.fizzy.yml`
+- `ProjectConfig` class that walks up directories to find nearest `.fizzy.yml`
+- Resolution priority: CLI flag > `.fizzy.yml` > global tokens.yml default
+- `Auth.token_data` class method to centralize token file reading
+- `--board` is now optional for columns and card create when set in `.fizzy.yml`
+
+### Fixed
+- Client follows Location header on any 2xx with empty body, not just 201
+- All update commands handle nil response body instead of crashing with NoMethodError
+- Skill file incorrectly documented `fizzy identity` instead of `fizzy auth identity`
+- Guard against empty string in `--board` and `--account` flag values
+- `ProjectConfig` rescues `Psych::SyntaxError` with user-friendly error message
+- Blank or non-hash `.fizzy.yml` files treated as empty config instead of crashing
+
+## [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

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
@@ -39,6 +51,26 @@ fizzy auth accounts   # List available accounts
 fizzy auth switch SLUG  # Change default account
 ```
 
+## Project Configuration
+
+Set project-level defaults so you don't need `--account` and `--board` on every command:
+
+```sh
+fizzy init
+```
+
+This creates a `.fizzy.yml` in the current directory:
+
+```yaml
+account: acme
+board: b1
+```
+
+**Resolution priority** (highest wins):
+1. CLI flag (`--account` / `--board`)
+2. `.fizzy.yml` (nearest ancestor directory)
+3. Global `default_account` from `~/.config/fizzy-cli/tokens.yml`
+
 ## Usage
 
 All commands support `--json` for JSON output and `--account SLUG` to override the default account.
@@ -178,6 +210,7 @@ end
 
 | Source | Purpose |
 |--------|---------|
+| `.fizzy.yml` | Per-project account and board defaults |
 | `~/.config/fizzy-cli/tokens.yml` | Stored auth tokens and default account |
 | `FIZZY_TOKEN` env var | Token override (requires `--account`) |
 
@@ -190,26 +223,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/auth.rb

@@ -19,13 +19,17 @@ module Fizzy
       slug&.delete_prefix("/")
     end
 
-    def self.resolve_from_file(account_slug)
+    def self.token_data
       unless File.exist?(TOKEN_FILE)
         raise AuthError,
               "No tokens file at #{TOKEN_FILE}. Run: fizzy auth login --token TOKEN"
       end
 
-      data = YAML.safe_load_file(TOKEN_FILE, permitted_classes: [Time])
+      YAML.safe_load_file(TOKEN_FILE, permitted_classes: [Time])
+    end
+
+    def self.resolve_from_file(account_slug)
+      data = token_data
       slug = normalize_slug(account_slug || data["default_account"])
       account = data["accounts"]&.find { |a| normalize_slug(a["account_slug"]) == slug }
       raise AuthError, "No account found for #{slug}" unless account

data/lib/fizzy/cli/base.rb

@@ -17,8 +17,24 @@ module Fizzy
         parent_options || options
       end
 
+      def project_config
+        @project_config ||= ProjectConfig.new
+      end
+
       def account
-        @account ||= Auth.resolve(global_options[:account])
+        slug = global_options[:account]
+        slug = nil if slug&.empty?
+        @account ||= Auth.resolve(slug || project_config.account)
+      end
+
+      def board
+        b = options[:board]
+        b && !b.empty? ? b : project_config.board
+      end
+
+      def require_board!
+        board || raise(Thor::Error,
+                       "No value provided for option '--board'. Set via --board, .fizzy.yml, or: fizzy init")
       end
 
       def client

data/lib/fizzy/cli/boards.rb

@@ -41,10 +41,14 @@ module Fizzy
       def update(board_id)
         resp = client.put("boards/#{board_id}", body: { name: options[:name] })
         b = resp.body
-        output_detail(b, pairs: [
-                        ["ID", b["id"]],
-                        ["Name", b["name"]]
-                      ])
+        if b
+          output_detail(b, pairs: [
+                          ["ID", b["id"]],
+                          ["Name", b["name"]]
+                        ])
+        else
+          puts "Board #{board_id} updated."
+        end
       end
 
       desc "delete BOARD_ID", "Delete a board"

data/lib/fizzy/cli/cards.rb

@@ -51,14 +51,14 @@ module Fizzy
       end
 
       desc "create TITLE", "Create a card"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       option :body, desc: "Card body (HTML)"
       option :column, desc: "Column ID"
       def create(title)
         body = { title: title }
         body[:body] = options[:body] if options[:body]
         body[:column_id] = options[:column] if options[:column]
-        resp = client.post("boards/#{options[:board]}/cards", body: body)
+        resp = client.post("boards/#{require_board!}/cards", body: body)
         c = resp.body
         output_detail(c, pairs: [
                         ["Number", "##{c["number"]}"],
@@ -73,10 +73,14 @@ module Fizzy
       def update(number)
         resp = client.put("cards/#{number}", body: build_body(:title, :body))
         c = resp.body
-        output_detail(c, pairs: [
-                        ["Number", "##{c["number"]}"],
-                        ["Title", c["title"]]
-                      ])
+        if c
+          output_detail(c, pairs: [
+                          ["Number", "##{c["number"]}"],
+                          ["Title", c["title"]]
+                        ])
+        else
+          puts "Card ##{number} updated."
+        end
       end
 
       desc "delete NUMBER", "Delete a card"

data/lib/fizzy/cli/columns.rb

@@ -6,18 +6,18 @@ module Fizzy
       include Base
 
       desc "list", "List columns for a board"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       def list
-        data = paginator.all("boards/#{options[:board]}/columns")
+        data = paginator.all("boards/#{require_board!}/columns")
         output_list(data, headers: %w[ID Name Position]) do |c|
           [c["id"], c["name"], c["position"]]
         end
       end
 
       desc "get COLUMN_ID", "Show a column"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       def get(column_id)
-        resp = client.get("boards/#{options[:board]}/columns/#{column_id}")
+        resp = client.get("boards/#{require_board!}/columns/#{column_id}")
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -28,9 +28,9 @@ module Fizzy
       end
 
       desc "create NAME", "Create a column"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       def create(name)
-        resp = client.post("boards/#{options[:board]}/columns", body: { name: name })
+        resp = client.post("boards/#{require_board!}/columns", body: { name: name })
         c = resp.body
         output_detail(c, pairs: [
                         ["ID", c["id"]],
@@ -39,21 +39,25 @@ module Fizzy
       end
 
       desc "update COLUMN_ID", "Update a column"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       option :name, required: true, desc: "New column name"
       def update(column_id)
-        resp = client.put("boards/#{options[:board]}/columns/#{column_id}", body: { name: options[:name] })
+        resp = client.put("boards/#{require_board!}/columns/#{column_id}", body: { name: options[:name] })
         c = resp.body
-        output_detail(c, pairs: [
-                        ["ID", c["id"]],
-                        ["Name", c["name"]]
-                      ])
+        if c
+          output_detail(c, pairs: [
+                          ["ID", c["id"]],
+                          ["Name", c["name"]]
+                        ])
+        else
+          puts "Column #{column_id} updated."
+        end
       end
 
       desc "delete COLUMN_ID", "Delete a column"
-      option :board, required: true, desc: "Board ID"
+      option :board, desc: "Board ID"
       def delete(column_id)
-        client.delete("boards/#{options[:board]}/columns/#{column_id}")
+        client.delete("boards/#{require_board!}/columns/#{column_id}")
         puts "Column #{column_id} deleted."
       end
     end

data/lib/fizzy/cli/comments.rb

@@ -44,10 +44,14 @@ module Fizzy
       def update(comment_id)
         resp = client.put("cards/#{options[:card]}/comments/#{comment_id}", body: build_body(:body))
         c = resp.body
-        output_detail(c, pairs: [
-                        ["ID", c["id"]],
-                        ["Body", c["body"]]
-                      ])
+        if c
+          output_detail(c, pairs: [
+                          ["ID", c["id"]],
+                          ["Body", c["body"]]
+                        ])
+        else
+          puts "Comment #{comment_id} updated."
+        end
       end
 
       desc "delete COMMENT_ID", "Delete a comment"

data/lib/fizzy/cli/steps.rb

@@ -37,11 +37,15 @@ module Fizzy
         path = "cards/#{options[:card]}/steps/#{step_id}"
         resp = client.put(path, body: build_body(:description, :completed))
         s = resp.body
-        output_detail(s, pairs: [
-                        ["ID", s["id"]],
-                        ["Description", s["description"]],
-                        ["Completed", s["completed"]]
-                      ])
+        if s
+          output_detail(s, pairs: [
+                          ["ID", s["id"]],
+                          ["Description", s["description"]],
+                          ["Completed", s["completed"]]
+                        ])
+        else
+          puts "Step #{step_id} updated."
+        end
       end
 
       desc "delete STEP_ID", "Delete a step"

data/lib/fizzy/cli/users.rb

@@ -33,11 +33,15 @@ module Fizzy
       def update(user_id)
         resp = client.put("users/#{user_id}", body: build_body(:name, :role))
         u = resp.body
-        output_detail(u, pairs: [
-                        ["ID", u["id"]],
-                        ["Name", u["name"]],
-                        ["Role", u["role"]]
-                      ])
+        if u
+          output_detail(u, pairs: [
+                          ["ID", u["id"]],
+                          ["Name", u["name"]],
+                          ["Role", u["role"]]
+                        ])
+        else
+          puts "User #{user_id} updated."
+        end
       end
 
       desc "deactivate USER_ID", "Deactivate a user"

data/lib/fizzy/cli.rb

@@ -25,6 +25,19 @@ module Fizzy
       puts "fizzy-cli #{VERSION}"
     end
 
+    desc "init", "Create .fizzy.yml in current directory"
+    def init
+      config_path = File.join(Dir.pwd, ProjectConfig::FILENAME)
+      return if File.exist?(config_path) && !yes?("#{config_path} already exists. Overwrite?")
+
+      selected = pick_account
+      config = { "account" => selected["account_slug"] }
+      config["board"] = pick_board(selected) if yes?("Set a default board?")
+
+      File.write(config_path, YAML.dump(config))
+      say "Wrote #{config_path}"
+    end
+
     desc "boards SUBCOMMAND ...ARGS", "Manage boards"
     subcommand "boards", CLI::Boards
 
@@ -62,5 +75,47 @@ module Fizzy
     subcommand "skill", CLI::Skill
 
     def self.exit_on_failure? = true
+
+    private
+
+    def pick_account
+      data = Auth.token_data
+      accounts = Array(data["accounts"])
+      raise AuthError, "No accounts found. Run: fizzy auth login --token TOKEN" if accounts.empty?
+
+      say "Available accounts:"
+      accounts.each_with_index do |a, i|
+        marker = a["account_slug"] == data["default_account"] ? " (default)" : ""
+        say "  #{i + 1}. #{a["account_name"]} (#{a["account_slug"]})#{marker}"
+      end
+
+      choice = ask("Select account number [1]:").strip
+      choice = "1" if choice.empty?
+      idx = choice.to_i - 1
+      raise Thor::Error, "Invalid selection" unless idx >= 0 && idx < accounts.size
+
+      accounts[idx]
+    end
+
+    def pick_board(account)
+      c = Client.new(token: account["access_token"], account_slug: account["account_slug"])
+      boards = c.get("boards").body
+
+      if boards.empty?
+        say "No boards found."
+        return nil
+      end
+
+      say "Boards:"
+      boards.each_with_index do |b, i|
+        say "  #{i + 1}. #{b["name"]} (#{b["id"]})"
+      end
+
+      board_idx = ask("Select board number:").strip.to_i - 1
+      return boards[board_idx]["id"] if board_idx >= 0 && board_idx < boards.size
+
+      say "Invalid selection, skipping board."
+      nil
+    end
   end
 end

data/lib/fizzy/client.rb

@@ -81,8 +81,8 @@ module Fizzy
 
       case status
       when 200..299
-        # Follow Location header on 201 to fetch the created resource
-        if status == 201 && parsed_body.nil? && response["location"]
+        # Follow Location header to fetch the resource when body is empty
+        if parsed_body.nil? && response["location"]
           location = response["location"].sub(/\.json$/, "")
           return get(location)
         end

data/lib/fizzy/project_config.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Fizzy
+  class ProjectConfig
+    FILENAME = ".fizzy.yml"
+
+    attr_reader :path
+
+    def initialize(start_dir = Dir.pwd)
+      @path = find_config(start_dir)
+      data = @path ? YAML.safe_load_file(@path) : {}
+      @data = data.is_a?(Hash) ? data : {}
+    rescue Psych::SyntaxError => e
+      raise Thor::Error, "Bad .fizzy.yml at #{@path}: #{e.message}"
+    end
+
+    def found? = !@path.nil?
+
+    def account = @data["account"]
+
+    def board = @data["board"]
+
+    private
+
+    def find_config(dir)
+      candidate = File.join(dir, FILENAME)
+      return candidate if File.exist?(candidate)
+
+      parent = File.dirname(dir)
+      return nil if parent == dir
+
+      find_config(parent)
+    end
+  end
+end

data/lib/fizzy/version.rb

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

data/lib/fizzy.rb

@@ -8,6 +8,7 @@ require "yaml"
 require_relative "fizzy/version"
 require_relative "fizzy/errors"
 require_relative "fizzy/auth"
+require_relative "fizzy/project_config"
 require_relative "fizzy/client"
 require_relative "fizzy/paginator"
 require_relative "fizzy/formatter"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fizzy-cli
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - David Paluy
@@ -59,6 +59,7 @@ files:
 - lib/fizzy/errors.rb
 - lib/fizzy/formatter.rb
 - lib/fizzy/paginator.rb
+- lib/fizzy/project_config.rb
 - lib/fizzy/version.rb
 homepage: https://github.com/dpaluy/fizzy-cli
 licenses: