fizzy-cli 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 070407ac06ff5b533dce440bc1eb62452c32adc089880a011e3c2af7fdb13b4b
-  data.tar.gz: 241fcbec138baedbd064f4b87f2ab327685ed41eec614661431dee91bac5ed0f
+  metadata.gz: 3c7249d6d732c7829bdb9e165d6b5972995952c92771d59ca80f7335a95b2af8
+  data.tar.gz: 0436f2a6c63316375ffa19488f2d1b4ecef6fc1066fd1422ccad3124069b1585
 SHA512:
-  metadata.gz: a2ce69faf33ec985574500bafb3b2c896d667e7576fec78bc06d1683c9436458f493a8afff7061e8f6e54bfdc74bd1faed544a15560426b6704482f433dbdc3a
-  data.tar.gz: '009907a2a395c93e696cede48a408c776037594e668545f36ca06489df7e6d8bcb2c14bc040472ee5ef80e21c00f3a9445525ea2129016884d6fea6cbacb0b66'
+  metadata.gz: bec62220f8d21d6edceab3a0d1dc7835ca5cb5c1f0f404d5923cf3eed3eef0c4330798e8dab644c3bafe88d70e3e8c2c747398d5742baa90311684aaa323afe9
+  data.tar.gz: 0d106800ad06848b59ec24fe0bcb0a6802f71f131a0890698ef133ce6c2276d927e7922473d759958c4554905725fa975abc72cfcb58e43f8583952e08800297

data/CHANGELOG.md

@@ -5,6 +5,13 @@ 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.0] - 2026-02-22
+
+### Added
+- `fizzy skill install` command to install AI skill files for Claude Code and Codex
+- `fizzy skill uninstall` command to remove installed skill files
+- `--target` option (claude, codex, all) and `--scope` option (user, project)
+
 ## [0.2.2] - 2026-02-21
 
 ### Fixed

data/README.md

@@ -190,6 +190,26 @@ 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/skill.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "fileutils"
+
+module Fizzy
+  class CLI < Thor
+    class Skill < Thor
+      namespace "skill"
+
+      SKILL_URL = "https://raw.githubusercontent.com/dpaluy/fizzy-cli/master/skills/fizzy-cli/SKILL.md"
+
+      TARGET_PATHS = {
+        "claude" => {
+          "user" => File.join(Dir.home, ".claude", "skills", "fizzy-cli"),
+          "project" => File.join(".claude", "skills", "fizzy-cli")
+        },
+        "codex" => {
+          "user" => File.join(Dir.home, ".agents", "skills", "fizzy-cli"),
+          "project" => File.join(".agents", "skills", "fizzy-cli")
+        }
+      }.freeze
+
+      desc "install", "Install AI skill file for fizzy-cli"
+      option :target, type: :string, default: "claude", enum: %w[claude codex all], desc: "Target agent"
+      option :scope, type: :string, default: "user", enum: %w[user project], desc: "Install scope"
+      def install
+        content = fetch_skill
+
+        targets_for(options[:target]).each do |target|
+          dir = TARGET_PATHS.dig(target, options[:scope])
+          path = File.join(dir, "SKILL.md")
+
+          if File.exist?(path) && File.read(path) == content
+            say "Already up to date: #{path}"
+          else
+            verb = File.exist?(path) ? "Updated" : "Installed"
+            FileUtils.mkdir_p(dir)
+            File.write(path, content)
+            say "#{verb}: #{path}"
+          end
+        end
+      end
+
+      desc "uninstall", "Remove AI skill file for fizzy-cli"
+      option :target, type: :string, default: "claude", enum: %w[claude codex all], desc: "Target agent"
+      option :scope, type: :string, default: "user", enum: %w[user project], desc: "Install scope"
+      def uninstall
+        targets_for(options[:target]).each do |target|
+          dir = TARGET_PATHS.dig(target, options[:scope])
+
+          unless File.directory?(dir)
+            say "Not installed: #{dir}"
+            next
+          end
+
+          FileUtils.rm_rf(dir)
+          say "Removed: #{dir}"
+        end
+      end
+
+      def self.exit_on_failure? = true
+
+      private
+
+      def targets_for(target)
+        target == "all" ? %w[claude codex] : [target]
+      end
+
+      def fetch_skill
+        uri = URI(SKILL_URL)
+        response = Net::HTTP.get_response(uri)
+
+        raise Thor::Error, "Failed to fetch skill file (HTTP #{response.code})" unless response.is_a?(Net::HTTPSuccess)
+
+        response.body.force_encoding("UTF-8")
+      rescue SocketError, Errno::ECONNREFUSED, Net::OpenTimeout, Net::ReadTimeout => e
+        raise Thor::Error, "Could not fetch skill file: #{e.message}"
+      end
+    end
+  end
+end

data/lib/fizzy/cli.rb

@@ -13,6 +13,7 @@ require_relative "cli/users"
 require_relative "cli/notifications"
 require_relative "cli/pins"
 require_relative "cli/auth"
+require_relative "cli/skill"
 
 module Fizzy
   class CLI < Thor
@@ -57,6 +58,9 @@ module Fizzy
     desc "auth SUBCOMMAND ...ARGS", "Authentication commands"
     subcommand "auth", CLI::AuthCommands
 
+    desc "skill SUBCOMMAND ...ARGS", "Manage AI skill files"
+    subcommand "skill", CLI::Skill
+
     def self.exit_on_failure? = true
   end
 end

data/lib/fizzy/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fizzy-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - David Paluy
@@ -51,6 +51,7 @@ files:
 - lib/fizzy/cli/notifications.rb
 - lib/fizzy/cli/pins.rb
 - lib/fizzy/cli/reactions.rb
+- lib/fizzy/cli/skill.rb
 - lib/fizzy/cli/steps.rb
 - lib/fizzy/cli/tags.rb
 - lib/fizzy/cli/users.rb