confluence-cli 1.12.1 → 1.13.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.13.0](https://github.com/pchuri/confluence-cli/compare/v1.12.1...v1.13.0) (2026-01-08)
+
+
+### Features
+
+* add children command to list child pages ([#27](https://github.com/pchuri/confluence-cli/issues/27)) ([7e8b4ed](https://github.com/pchuri/confluence-cli/commit/7e8b4ed1b0ed69a7e1de52dfaf0c1ff36973f78b))
+
 ## [1.12.1](https://github.com/pchuri/confluence-cli/compare/v1.12.0...v1.12.1) (2025-12-31)
 
 

package/README.md

@@ -44,12 +44,17 @@ npx confluence-cli
    confluence search "my search term"
    ```
 
-4. **Create a new page:**
+4. **List child pages:**
+   ```bash
+   confluence children 123456789
+   ```
+
+5. **Create a new page:**
    ```bash
    confluence create "My New Page" SPACEKEY --content "Hello World!"
    ```
 
-5. **Update a page:**
+6. **Update a page:**
    ```bash
    confluence update 123456789 --content "Updated content"
    ```
@@ -139,6 +144,27 @@ confluence export 123456789 --skip-attachments
 confluence spaces
 ```
 
+### List Child Pages
+```bash
+# List direct child pages
+confluence children 123456789
+
+# List all descendants recursively
+confluence children 123456789 --recursive
+
+# Display as tree structure
+confluence children 123456789 --recursive --format tree
+
+# Show page IDs and URLs
+confluence children 123456789 --show-id --show-url
+
+# Limit recursion depth
+confluence children 123456789 --recursive --max-depth 3
+
+# Output as JSON for scripting
+confluence children 123456789 --recursive --format json > children.json
+```
+
 ### Find a Page by Title
 ```bash
 # Find page by title
@@ -250,6 +276,7 @@ confluence stats
 | `search <query>` | Search for pages | `--limit <number>` |
 | `spaces` | List all available spaces | |
 | `find <title>` | Find a page by its title | `--space <spaceKey>` |
+| `children <pageId>` | List child pages of a page | `--recursive`, `--max-depth <number>`, `--format <list\|tree\|json>`, `--show-url`, `--show-id` |
 | `create <title> <spaceKey>` | Create a new page | `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>`|
 | `create-child <title> <parentId>` | Create a child page | `--content <string>`, `--file <path>`, `--format <storage\|html\|markdown>` |
 | `copy-tree <sourcePageId> <targetParentId> [newTitle]` | Copy page tree with all children | `--max-depth <number>`, `--exclude <patterns>`, `--delay-ms <ms>`, `--copy-suffix <text>`, `--dry-run`, `--fail-on-error`, `--quiet` |

package/bin/confluence.js

@@ -706,6 +706,159 @@ program
     }
   });
 
+// List children command
+program
+  .command('children <pageId>')
+  .description('List child pages of a Confluence page')
+  .option('-r, --recursive', 'List all descendants recursively', false)
+  .option('--max-depth <number>', 'Maximum depth for recursive listing', '10')
+  .option('--format <format>', 'Output format (list, tree, json)', 'list')
+  .option('--show-url', 'Show page URLs', false)
+  .option('--show-id', 'Show page IDs', false)
+  .action(async (pageId, options) => {
+    const analytics = new Analytics();
+    try {
+      const config = getConfig();
+      const client = new ConfluenceClient(config);
+      
+      // Extract page ID from URL if needed
+      const resolvedPageId = await client.extractPageId(pageId);
+      
+      // Get children
+      let children;
+      if (options.recursive) {
+        const maxDepth = parseInt(options.maxDepth) || 10;
+        children = await client.getAllDescendantPages(resolvedPageId, maxDepth);
+      } else {
+        children = await client.getChildPages(resolvedPageId);
+      }
+      
+      if (children.length === 0) {
+        console.log(chalk.yellow('No child pages found.'));
+        analytics.track('children', true);
+        return;
+      }
+      
+      // Format output
+      const format = options.format.toLowerCase();
+      
+      if (format === 'json') {
+        // JSON output
+        const output = {
+          pageId: resolvedPageId,
+          childCount: children.length,
+          children: children.map(page => ({
+            id: page.id,
+            title: page.title,
+            type: page.type,
+            status: page.status,
+            spaceKey: page.space?.key,
+            url: `https://${config.domain}/wiki/spaces/${page.space?.key}/pages/${page.id}`,
+            parentId: page.parentId || resolvedPageId
+          }))
+        };
+        console.log(JSON.stringify(output, null, 2));
+      } else if (format === 'tree' && options.recursive) {
+        // Tree format (only for recursive mode)
+        const pageInfo = await client.getPageInfo(resolvedPageId);
+        console.log(chalk.blue(`📁 ${pageInfo.title}`));
+        
+        // Build tree structure
+        const tree = buildTree(children, resolvedPageId);
+        printTree(tree, config, options, 1);
+        
+        console.log('');
+        console.log(chalk.gray(`Total: ${children.length} child page${children.length === 1 ? '' : 's'}`));
+      } else {
+        // List format (default)
+        console.log(chalk.blue('Child pages:'));
+        console.log('');
+        
+        children.forEach((page, index) => {
+          let output = `${index + 1}. ${chalk.green(page.title)}`;
+          
+          if (options.showId) {
+            output += ` ${chalk.gray(`(ID: ${page.id})`)}`;
+          }
+          
+          if (options.showUrl) {
+            const url = `https://${config.domain}/wiki/spaces/${page.space?.key}/pages/${page.id}`;
+            output += `\n   ${chalk.gray(url)}`;
+          }
+          
+          if (options.recursive && page.parentId && page.parentId !== resolvedPageId) {
+            output += ` ${chalk.dim('(nested)')}`;
+          }
+          
+          console.log(output);
+        });
+        
+        console.log('');
+        console.log(chalk.gray(`Total: ${children.length} child page${children.length === 1 ? '' : 's'}`));
+      }
+      
+      analytics.track('children', true);
+    } catch (error) {
+      analytics.track('children', false);
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Helper function to build tree structure
+function buildTree(pages, rootId) {
+  const tree = [];
+  const pageMap = new Map();
+  
+  // Create a map of all pages
+  pages.forEach(page => {
+    pageMap.set(page.id, { ...page, children: [] });
+  });
+  
+  // Build tree structure
+  pages.forEach(page => {
+    const node = pageMap.get(page.id);
+    const parentId = page.parentId || rootId;
+    
+    if (parentId === rootId) {
+      tree.push(node);
+    } else {
+      const parent = pageMap.get(parentId);
+      if (parent) {
+        parent.children.push(node);
+      }
+    }
+  });
+  
+  return tree;
+}
+
+// Helper function to print tree
+function printTree(nodes, config, options, depth = 1) {
+  nodes.forEach((node, index) => {
+    const isLast = index === nodes.length - 1;
+    const indent = '  '.repeat(depth - 1);
+    const prefix = isLast ? '└── ' : '├── ';
+    
+    let output = `${indent}${prefix}📄 ${chalk.green(node.title)}`;
+    
+    if (options.showId) {
+      output += ` ${chalk.gray(`(ID: ${node.id})`)}`;
+    }
+    
+    if (options.showUrl) {
+      const url = `https://${config.domain}/wiki/spaces/${node.space?.key}/pages/${node.id}`;
+      output += `\n${indent}${isLast ? '    ' : '│   '}${chalk.gray(url)}`;
+    }
+    
+    console.log(output);
+    
+    if (node.children && node.children.length > 0) {
+      printTree(node.children, config, options, depth + 1);
+    }
+  });
+}
+
 if (process.argv.length <= 2) {
   program.help({ error: false });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence-cli",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "A command-line interface for Atlassian Confluence with page creation and editing capabilities",
   "main": "index.js",
   "bin": {