confluence-cli 1.27.8 → 1.29.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "pchuri-confluence-cli",
+  "owner": {
+    "name": "pchuri"
+  },
+  "metadata": {
+    "description": "Claude Code plugins for Atlassian Confluence CLI.",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "confluence",
+      "description": "Use confluence-cli to read, search, create, update, move, delete, and convert Confluence pages and attachments from the terminal.",
+      "source": "./plugins/confluence"
+    }
+  ]
+}

package/README.md

@@ -18,6 +18,7 @@ A powerful command-line interface for Atlassian Confluence that allows you to re
 - 🛠️ **Edit workflow** - Export page content for editing and re-import
 - 🔀 **Profiles** - Manage multiple Confluence instances with named configuration profiles
 - 🔒 **Read-only mode** - Profile-level write protection for safe AI agent usage
+- 🔄 **Format conversion** - Convert between Markdown, HTML, Storage, and text formats locally (no server required)
 - 🔧 **Easy setup** - Simple configuration with environment variables or interactive setup
 
 ## Installation
@@ -39,17 +40,28 @@ Or run directly with npx:
 npx confluence-cli
 ```
 
-## Claude Code AI Skills
+## Claude Code Integration
 
-If you use [Claude Code](https://claude.ai/code) or any AI agent that reads `.claude/skills/`, install the skill documentation so the agent understands all confluence-cli commands automatically.
+confluence-cli ships as a [Claude Code plugin](https://docs.anthropic.com/en/docs/claude-code/plugins). Once installed, Claude Code understands all confluence-cli commands automatically and receives updates when the skill is improved.
 
-Run this from your project root after installing confluence-cli:
+### Option 1: Install as Plugin (recommended)
+
+Add the marketplace and install the plugin:
+
+```bash
+/plugin marketplace add pchuri/confluence-cli
+/plugin install confluence@pchuri-confluence-cli
+```
+
+### Option 2: Install Skill manually
+
+If you prefer not to use the plugin system, copy the skill documentation into your project:
 
 ```bash
 confluence install-skill
 ```
 
-This creates `.claude/skills/confluence/SKILL.md` in your current directory. Claude Code picks it up automatically and can help you with any confluence-cli command.
+This creates `.claude/skills/confluence/SKILL.md` in your current directory. Claude Code picks it up automatically.
 
 ## Quick Start
 
@@ -555,6 +567,7 @@ confluence stats
 | `profile use <name>` | Set the active configuration profile | |
 | `profile add <name>` | Add a new configuration profile | `-d, --domain`, `-p, --api-path`, `-a, --auth-type`, `-e, --email`, `-t, --token`, `--protocol`, `--read-only` |
 | `profile remove <name>` | Remove a configuration profile | |
+| `convert` | Convert between content formats locally (no server required) | `--input-file <path>`, `--output-file <path>`, `--input-format <markdown\|storage\|html>`, `--output-format <markdown\|storage\|html\|text>` |
 | `stats` | View your usage statistics | |
 
 **Global option:** `--profile <name>` — Use a specific profile for any command (overrides `CONFLUENCE_PROFILE` env var and active profile).
@@ -597,6 +610,15 @@ confluence stats
 confluence profile list
 confluence profile use staging
 confluence --profile staging spaces
+
+# Convert markdown to Confluence storage format (no server required)
+confluence convert --input-file doc.md --input-format markdown --output-format storage
+
+# Pipe conversion via stdin/stdout
+echo "# Hello" | confluence convert --input-format markdown --output-format storage
+
+# Convert storage format back to markdown
+confluence convert -i page.xml -o page.md --input-format storage --output-format markdown
 ```
 
 ## Development

package/bin/confluence.js

@@ -167,7 +167,7 @@ program
     const fs = require('fs');
     const path = require('path');
 
-    const skillSrc = path.join(__dirname, '..', '.claude', 'skills', 'confluence', 'SKILL.md');
+    const skillSrc = path.join(__dirname, '..', 'plugins', 'confluence', 'skills', 'confluence', 'SKILL.md');
 
     if (!fs.existsSync(skillSrc)) {
       console.error(chalk.red('Error: skill file not found in package. Try reinstalling confluence-cli.'));
@@ -1952,6 +1952,93 @@ profileCmd
     }
   });
 
+// Convert command (local format conversion, no server connection required)
+const VALID_INPUT_FORMATS = ['markdown', 'storage', 'html'];
+const VALID_OUTPUT_FORMATS = ['markdown', 'storage', 'html', 'text'];
+
+program
+  .command('convert')
+  .description('Convert between content formats locally (no server connection required)')
+  .option('-i, --input-file <file>', 'Input file path (reads from stdin if omitted)')
+  .option('-o, --output-file <file>', 'Output file path (writes to stdout if omitted)')
+  .option('--input-format <format>', `Input format (${VALID_INPUT_FORMATS.join(', ')})`)
+  .option('--output-format <format>', `Output format (${VALID_OUTPUT_FORMATS.join(', ')})`)
+  .action(async (options) => {
+    const analytics = new Analytics();
+    try {
+      if (!options.inputFormat) {
+        console.error(chalk.red('Error: --input-format is required.'));
+        process.exit(1);
+      }
+      if (!options.outputFormat) {
+        console.error(chalk.red('Error: --output-format is required.'));
+        process.exit(1);
+      }
+      if (!VALID_INPUT_FORMATS.includes(options.inputFormat)) {
+        console.error(chalk.red(`Error: Invalid input format "${options.inputFormat}". Valid: ${VALID_INPUT_FORMATS.join(', ')}`));
+        process.exit(1);
+      }
+      if (!VALID_OUTPUT_FORMATS.includes(options.outputFormat)) {
+        console.error(chalk.red(`Error: Invalid output format "${options.outputFormat}". Valid: ${VALID_OUTPUT_FORMATS.join(', ')}`));
+        process.exit(1);
+      }
+      if (options.inputFormat === options.outputFormat) {
+        console.error(chalk.red('Error: Input and output formats must be different.'));
+        process.exit(1);
+      }
+
+      const fs = require('fs');
+      let input;
+      if (options.inputFile) {
+        input = fs.readFileSync(options.inputFile, 'utf-8');
+      } else {
+        input = fs.readFileSync(process.stdin.fd, 'utf-8');
+      }
+
+      const converter = ConfluenceClient.createLocalConverter();
+      let output;
+
+      if (options.inputFormat === 'markdown' && options.outputFormat === 'storage') {
+        output = converter.markdownToStorage(input);
+      } else if (options.inputFormat === 'markdown' && options.outputFormat === 'html') {
+        output = converter.markdown.render(input);
+      } else if (options.inputFormat === 'html' && options.outputFormat === 'storage') {
+        output = converter.htmlToConfluenceStorage(input);
+      } else if (options.inputFormat === 'storage' && options.outputFormat === 'markdown') {
+        output = converter.storageToMarkdown(input);
+      } else if (options.inputFormat === 'storage' && options.outputFormat === 'text') {
+        const { convert: htmlToText } = require('html-to-text');
+        output = htmlToText(input, { wordwrap: 130 });
+      } else if (options.inputFormat === 'storage' && options.outputFormat === 'html') {
+        output = input; // storage format is already HTML-based
+      } else if (options.inputFormat === 'html' && options.outputFormat === 'text') {
+        const { convert: htmlToText } = require('html-to-text');
+        output = htmlToText(input, { wordwrap: 130 });
+      } else if (options.inputFormat === 'html' && options.outputFormat === 'markdown') {
+        output = converter.storageToMarkdown(input);
+      } else if (options.inputFormat === 'markdown' && options.outputFormat === 'text') {
+        const html = converter.markdown.render(input);
+        const { convert: htmlToText } = require('html-to-text');
+        output = htmlToText(html, { wordwrap: 130 });
+      } else {
+        console.error(chalk.red(`Error: Conversion from "${options.inputFormat}" to "${options.outputFormat}" is not supported.`));
+        process.exit(1);
+      }
+
+      if (options.outputFile) {
+        fs.writeFileSync(options.outputFile, output, 'utf-8');
+        console.error(chalk.green(`Converted ${options.inputFormat} → ${options.outputFormat}: ${options.outputFile}`));
+      } else {
+        process.stdout.write(output);
+      }
+      analytics.track('convert', true);
+    } catch (error) {
+      analytics.track('convert', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
 // Exported for testing
 module.exports = {
   program,

package/lib/confluence-client.js

@@ -2104,5 +2104,12 @@ class ConfluenceClient {
   }
 }
 
+ConfluenceClient.createLocalConverter = function () {
+  const instance = Object.create(ConfluenceClient.prototype);
+  instance.markdown = new MarkdownIt();
+  instance.setupConfluenceMarkdownExtensions();
+  return instance;
+};
+
 module.exports = ConfluenceClient;
 module.exports.NAMED_ENTITIES = NAMED_ENTITIES;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "confluence-cli",
-  "version": "1.27.8",
+  "version": "1.29.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "confluence-cli",
-      "version": "1.27.8",
+      "version": "1.29.0",
       "license": "MIT",
       "dependencies": {
         "axios": "^1.12.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence-cli",
-  "version": "1.27.8",
+  "version": "1.29.0",
   "description": "A command-line interface for Atlassian Confluence with page creation and editing capabilities",
   "main": "index.js",
   "bin": {
@@ -58,7 +58,8 @@
   "files": [
     "bin/",
     "lib/",
-    ".claude/skills/",
+    "plugins/",
+    ".claude-plugin/",
     "npm-shrinkwrap.json"
   ]
 }

package/plugins/confluence/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "confluence",
+  "description": "Use confluence-cli to read, search, create, update, move, delete, and convert Confluence pages and attachments from the terminal.",
+  "author": {
+    "name": "pchuri"
+  },
+  "homepage": "https://github.com/pchuri/confluence-cli#readme",
+  "repository": "https://github.com/pchuri/confluence-cli",
+  "license": "MIT",
+  "keywords": [
+    "confluence",
+    "atlassian",
+    "wiki",
+    "documentation",
+    "cli"
+  ]
+}

package/plugins/confluence/README.md

@@ -0,0 +1,27 @@
+# confluence
+
+A Claude Code plugin for [confluence-cli](https://github.com/pchuri/confluence-cli). Gives Claude Code full knowledge of all confluence-cli commands so it can read, search, create, update, move, delete, and convert Confluence pages and attachments on your behalf.
+
+## Installation
+
+Add the marketplace and install the plugin:
+
+```bash
+/plugin marketplace add pchuri/confluence-cli
+/plugin install confluence@pchuri-confluence-cli
+```
+
+## Prerequisites
+
+confluence-cli must be installed and configured:
+
+```bash
+npm install -g confluence-cli
+confluence init
+```
+
+See the [main README](../../README.md) for full configuration options.
+
+## What this plugin provides
+
+- **Skill: confluence** (model-invoked) — Claude Code automatically activates this skill when your task involves Confluence. It covers all 30+ CLI commands, configuration, common workflows, and error handling.

package/{.claude → plugins/confluence}/skills/confluence/SKILL.md

@@ -1,11 +1,13 @@
 ---
 name: confluence
-description: Use confluence-cli to read, search, create, update, move, and delete Confluence pages and attachments from the terminal.
+description: Use confluence-cli to read, search, create, update, move, delete, and convert Confluence pages and attachments from the terminal.
+argument-hint: <pageId, URL, search query, or task description>
+allowed-tools: [Bash, Read, Write, Glob, Grep]
 ---
 
 # confluence-cli Skill
 
-A CLI tool for Atlassian Confluence. Lets you read, search, create, update, move, and delete pages and attachments from the terminal or from an agent.
+A CLI tool for Atlassian Confluence. Lets you read, search, create, update, move, delete, and convert pages and attachments from the terminal or from an agent.
 
 ## Installation
 
@@ -627,6 +629,36 @@ confluence stats
 
 ---
 
+### `convert`
+
+Convert between content formats locally without a Confluence server connection.
+
+```sh
+confluence convert [--input-file <path>] [--output-file <path>] --input-format <format> --output-format <format>
+```
+
+| Option | Default | Description |
+|---|---|---|
+| `--input-file`, `-i` | stdin | Input file path |
+| `--output-file`, `-o` | stdout | Output file path |
+| `--input-format` | — | Input format: `markdown`, `storage`, `html` (required) |
+| `--output-format` | — | Output format: `markdown`, `storage`, `html`, `text` (required) |
+
+Supported conversions: markdown→storage, markdown→html, markdown→text, html→storage, html→text, html→markdown, storage→markdown, storage→html, storage→text.
+
+```sh
+# Markdown to Confluence storage format
+confluence convert -i doc.md -o doc.xml --input-format markdown --output-format storage
+
+# Pipe via stdin/stdout
+echo "# Hello" | confluence convert --input-format markdown --output-format storage
+
+# Storage format back to markdown
+confluence convert -i page.xml --input-format storage --output-format markdown
+```
+
+---
+
 ### `install-skill`
 
 Copy the Claude Code skill documentation into your project's `.claude/skills/` directory so Claude Code can learn confluence-cli automatically.
@@ -682,6 +714,16 @@ confluence copy-tree 123456789 987654321 --dry-run
 confluence copy-tree 123456789 987654321 "Backup Copy"
 ```
 
+### Offline format conversion
+
+```sh
+# Convert markdown to Confluence storage format (no server needed)
+confluence convert -i doc.md -o doc.xml --input-format markdown --output-format storage
+
+# Convert storage format to markdown for editing
+confluence convert -i page.xml -o page.md --input-format storage --output-format markdown
+```
+
 ### Export a page for local editing
 
 ```sh