discourse_cli_tool 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 688cddf126e1f109caa8824d80fc514566742cff6a5d1a535ccb7a27d8c0bae6
-  data.tar.gz: 37e886fb922d7481d80dfe8370419c03f6f45d4a6a6f0eee1086a01c151b7614
+  metadata.gz: 2f85a2451232e1d21e616d56497f3a2eefcd7875525278e61821454ef72069d3
+  data.tar.gz: 4849b6f1dfa072a46ff7855fd9bf637d6e28000324cc85aa737f852203fad5f9
 SHA512:
-  metadata.gz: b1f8f285a6d0138b95c991713cca48e47f61a42afb633a6e5fc3d9720674a43d78d61deb3308b9511203f5a458dc5cececffada7d5d9162ef811583da32a9177
-  data.tar.gz: bd8734e7f6f47197a8a65b7faa2b47d23dd3bbf6d3b7113702a0e3b1c405f8475968215aa76bee4098449457413c925895a803cd10a9d718ad5e3a2fc303c264
+  metadata.gz: 41e07d72153230d31b6572e2392e747dc076d9accba1d4b37abadb1a14422d95a0df2e4d599a631be472195fa6772ec952898523eec08d03ffd597387a0896f6
+  data.tar.gz: ee479f290a32beb230091d6647e40d540f5897b7db39ccb9f0bcba03c708d04c6a7cb7c61bfcad984d325ae79d3447c43a19137b5da9f7c2e2832c26976f6c5d

data/lib/discourse_cli/cli.rb

@@ -12,5 +12,6 @@ module DiscourseCli
     register(Commands::Categories, "categories", "categories <command>", "Manage categories")
     register(Commands::Topics,     "topics",     "topics <command>",     "Manage topics")
     register(Commands::Posts,      "posts",      "posts <command>",      "Manage posts")
+    register(Commands::Skill,      "skill",      "skill <command>",      "Manage the dsc LLM skill")
   end
 end

data/lib/discourse_cli/commands/skill.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "fileutils"
+
+module DiscourseCli
+  module Commands
+    class Skill < Base
+      def self.agent_paths
+        {
+          claude: File.expand_path("~/.claude/skills/dsc"),
+          codex:  File.expand_path("~/.codex/skills/dsc"),
+          gemini: File.expand_path("~/.gemini/skills/dsc"),
+        }
+      end
+
+      desc "install", "Install the dsc skill for LLM coding agents"
+      option :claude, type: :boolean, default: false, desc: "Install for Claude Code"
+      option :codex,  type: :boolean, default: false, desc: "Install for Codex"
+      option :gemini, type: :boolean, default: false, desc: "Install for Gemini CLI"
+      def install
+        targets = selected_agents
+        skill_source = self.class.skill_source
+
+        unless File.exist?(skill_source)
+          $stderr.puts "Skill source not found at #{skill_source}"
+          exit 1
+        end
+
+        targets.each do |agent, path|
+          FileUtils.mkdir_p(File.dirname(path))
+
+          if File.symlink?(path) && File.readlink(path) == skill_source
+            puts "#{agent}: already installed"
+            next
+          end
+
+          File.unlink(path) if File.symlink?(path) || File.exist?(path)
+          File.symlink(skill_source, path)
+          puts "#{agent}: installed → #{path}"
+        end
+      end
+
+      def self.skill_source
+        spec = Gem::Specification.find_by_name("discourse_cli_tool")
+        File.join(spec.gem_dir, "skill", "dsc")
+      rescue Gem::MissingSpecError
+        File.expand_path("../../../skill/dsc", __dir__)
+      end
+
+      private
+
+      def selected_agents
+        paths = self.class.agent_paths
+        any_selected = options[:claude] || options[:codex] || options[:gemini]
+        agents = any_selected ? {} : paths.dup
+        agents[:claude] = paths[:claude] if options[:claude]
+        agents[:codex]  = paths[:codex]  if options[:codex]
+        agents[:gemini] = paths[:gemini] if options[:gemini]
+        agents
+      end
+    end
+  end
+end

data/lib/discourse_cli/commands/topics.rb

@@ -22,7 +22,7 @@ module DiscourseCli
 
       desc "create", "Create a topic (opens $EDITOR if --raw not given)"
       option :title,    type: :string, required: true
-      option :category, type: :string
+      option :category, type: :numeric, desc: "Category ID"
       option :tags,     type: :string, desc: "Comma-separated tags"
       option :raw,      type: :string
       def create
@@ -37,7 +37,7 @@ module DiscourseCli
 
       desc "update ID", "Update a topic"
       option :title,    type: :string
-      option :category, type: :string, desc: "Category slug or name"
+      option :category, type: :numeric, desc: "Category ID"
       option :raw,      type: :string, desc: "Replace first post content (opens $EDITOR if not given and no other options)"
       def update(id)
         updated_anything = false
@@ -48,13 +48,7 @@ module DiscourseCli
         end
 
         if options[:category]
-          cats = client.categories
-          cat = cats.find { |c| c["slug"] == options[:category] || c["name"] == options[:category] }
-          unless cat
-            $stderr.puts "Category not found: #{options[:category]}"
-            exit 1
-          end
-          client.recategorize_topic(id.to_i, cat["id"])
+          client.recategorize_topic(id.to_i, options[:category])
           updated_anything = true
         end
 

data/lib/discourse_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DiscourseCli
-  VERSION = "0.1.0"
+  VERSION = "0.2.1"
 end

data/lib/discourse_cli.rb

@@ -10,4 +10,5 @@ require_relative "discourse_cli/commands/config"
 require_relative "discourse_cli/commands/categories"
 require_relative "discourse_cli/commands/topics"
 require_relative "discourse_cli/commands/posts"
+require_relative "discourse_cli/commands/skill"
 require_relative "discourse_cli/cli"

data/lib/rubygems_plugin.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+def dsc_skill_agent_paths
+  %w[
+    ~/.claude/skills/dsc
+    ~/.codex/skills/dsc
+    ~/.gemini/skills/dsc
+  ].map { |p| File.expand_path(p) }
+end
+
+Gem.post_install do |installer|
+  next unless installer.spec.name == "discourse_cli_tool"
+
+  skill_source = File.join(installer.spec.gem_dir, "skill", "dsc")
+  next unless File.exist?(skill_source)
+
+  dsc_skill_agent_paths.each do |path|
+    next unless File.symlink?(path)
+
+    File.unlink(path)
+    File.symlink(skill_source, path)
+  end
+end
+
+Gem.pre_uninstall do |uninstaller|
+  next unless uninstaller.spec.name == "discourse_cli_tool"
+
+  skill_source = File.join(uninstaller.spec.gem_dir, "skill", "dsc")
+
+  dsc_skill_agent_paths.each do |path|
+    next unless File.symlink?(path) && File.readlink(path) == skill_source
+
+    File.unlink(path)
+    puts "Removed dsc skill from #{path}"
+  end
+end

data/skill/dsc/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: dsc
+description: Manage Discourse forums from the command line — create and manage topics, posts, and categories using the dsc CLI. Use when working with a Discourse forum, creating posts or topics, managing categories, or any Discourse content task.
+---
+
+# dsc — Discourse CLI
+
+`dsc` wraps the Discourse API. Install: `gem install discourse_cli_tool`
+
+## Setup
+
+```bash
+dsc config set --site mysite --host https://forum.example.com --api-key KEY --api-username admin
+dsc config list
+```
+
+Config precedence: CLI flags > `DISCOURSE_HOST` / `DISCOURSE_API_KEY` / `DISCOURSE_API_USERNAME` env vars > `~/.config/dsc/config.yml`
+
+## Global flags
+
+| Flag | Description |
+|---|---|
+| `--site NAME` | Use a named site from config |
+| `--host URL` | Override host |
+| `--api-key KEY` | Override API key |
+| `--api-username USER` | Override API username |
+| `--json` | Output raw JSON (pipe to jq) |
+| `--quiet` | Suppress output, exit code only |
+
+## Raw content (topics and posts)
+
+Commands that accept `--raw` resolve content in this order:
+1. `--raw "inline content"` — use directly
+2. No flag, stdin is piped — read from stdin
+3. No flag, interactive terminal — open `$EDITOR`
+
+```bash
+dsc topics create --title "Hello" --raw "Content"      # inline
+echo "Content" | dsc topics create --title "Hello"     # stdin
+dsc topics create --title "Hello"                      # opens $EDITOR
+```
+
+## Command reference
+
+- **[references/categories.md](references/categories.md)** — list, show, create, update, delete categories
+- **[references/topics.md](references/topics.md)** — list, show, create, update, delete topics
+- **[references/posts.md](references/posts.md)** — list, show, create, update, delete posts

data/skill/dsc/references/categories.md

@@ -0,0 +1,39 @@
+# Categories
+
+## List
+
+```bash
+dsc categories list
+dsc categories list --json | jq '.[].name'
+```
+
+## Show
+
+```bash
+dsc categories show ID
+```
+
+## Create
+
+```bash
+dsc categories create --name "Announcements"
+dsc categories create --name "Announcements" --color 0088CC --text-color FFFFFF
+dsc categories create --name "Announcements" --description "Official announcements"
+```
+
+Options: `--name` (required), `--color HEX`, `--text-color HEX`, `--description TEXT`
+
+## Update
+
+```bash
+dsc categories update ID --name "News"
+dsc categories update ID --name "News" --color FF0000
+```
+
+Options: `--name` (required), `--color HEX`, `--text-color HEX`, `--description TEXT`
+
+## Delete
+
+```bash
+dsc categories delete ID
+```

data/skill/dsc/references/posts.md

@@ -0,0 +1,41 @@
+# Posts
+
+## List
+
+```bash
+dsc posts list
+dsc posts list --json
+```
+
+## Show
+
+```bash
+dsc posts show ID
+dsc posts show ID --json
+```
+
+## Create
+
+```bash
+dsc posts create --topic-id ID --raw "Reply content"
+dsc posts create --topic-id ID                           # opens $EDITOR
+echo "Reply" | dsc posts create --topic-id ID           # from stdin
+```
+
+Options: `--topic-id` (required), `--raw TEXT`
+
+## Update
+
+```bash
+dsc posts update ID --raw "Edited content"
+dsc posts update ID                                      # opens $EDITOR
+echo "New content" | dsc posts update ID                # from stdin
+```
+
+Options: `--raw TEXT`
+
+## Delete
+
+```bash
+dsc posts delete ID
+```

data/skill/dsc/references/topics.md

@@ -0,0 +1,49 @@
+# Topics
+
+## List
+
+```bash
+dsc topics list
+dsc topics list --category announcements
+dsc topics list --json | jq '.[].title'
+```
+
+## Show
+
+```bash
+dsc topics show ID
+dsc topics show ID --json
+```
+
+## Create
+
+```bash
+dsc topics create --title "Hello World" --raw "Content here"
+dsc topics create --title "Hello World" --category news
+dsc topics create --title "Hello World" --tags "tag1,tag2"
+dsc topics create --title "Hello World"                      # opens $EDITOR
+echo "Content" | dsc topics create --title "Hello World"    # from stdin
+```
+
+Options: `--title` (required), `--raw TEXT`, `--category SLUG`, `--tags TAG1,TAG2`
+
+## Update
+
+```bash
+dsc topics update ID --title "New Title"
+dsc topics update ID --raw "New content"       # edits first post, opens $EDITOR if omitted
+dsc topics update ID --category new-slug
+dsc topics update ID --title "New Title" --raw "New content"
+```
+
+Options: `--title TEXT`, `--raw TEXT`, `--category SLUG`
+
+Note: `--category` looks up category by slug or name. Updating raw content edits the topic's first post.
+
+When only `--title` or `--category` is given (no `--raw`, no piped stdin), content is left unchanged.
+
+## Delete
+
+```bash
+dsc topics delete ID
+```

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: discourse_cli_tool
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Tim Case
@@ -108,11 +108,17 @@ files:
 - lib/discourse_cli/commands/categories.rb
 - lib/discourse_cli/commands/config.rb
 - lib/discourse_cli/commands/posts.rb
+- lib/discourse_cli/commands/skill.rb
 - lib/discourse_cli/commands/topics.rb
 - lib/discourse_cli/config.rb
 - lib/discourse_cli/editor.rb
 - lib/discourse_cli/formatter.rb
 - lib/discourse_cli/version.rb
+- lib/rubygems_plugin.rb
+- skill/dsc/SKILL.md
+- skill/dsc/references/categories.md
+- skill/dsc/references/posts.md
+- skill/dsc/references/topics.md
 homepage: https://github.com/timcase/discourse-cli-tool
 licenses:
 - MIT
@@ -131,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.13
 specification_version: 4
 summary: CLI tool for managing Discourse forums from the command line
 test_files: []