Confluence CLI

A powerful command-line interface for Atlassian Confluence that allows you to read, search, and manage your Confluence content from the terminal.

Features

• 📖 Read pages - Get page content in text or HTML format
• 🔍 Search - Find pages using Confluence's powerful search
• ℹ️ Page info - Get detailed information about pages
• 🏠 List spaces - View all available Confluence spaces
• ✏️ Create pages - Create new pages with support for Markdown, HTML, or Storage format
• 📝 Update pages - Update existing page content and titles
• 📎 Attachments - List or download page attachments
• 📦 Export - Save a page and its attachments to a local folder
• 🛠️ Edit workflow - Export page content for editing and re-import
• 🔧 Easy setup - Simple configuration with environment variables or interactive setup

Installation

npm install -g confluence-cli

Or run directly with npx:

npx confluence-cli

Quick Start

1. Initialize configuration:

   confluence init

2. Read a page:

   confluence read 123456789

3. Search for pages:

   confluence search "my search term"

4. Create a new page:

   confluence create "My New Page" SPACEKEY --content "Hello World!"

5. Update a page:

   confluence update 123456789 --content "Updated content"

Configuration

Option 1: Interactive Setup

confluence init

The wizard now helps you choose the right API endpoint and authentication method. It recommends /wiki/rest/api for Atlassian Cloud domains (e.g., *.atlassian.net) and /rest/api for self-hosted/Data Center instances, then prompts for Basic (email + token) or Bearer authentication.

Option 2: Environment Variables

export CONFLUENCE_DOMAIN="your-domain.atlassian.net"
export CONFLUENCE_API_TOKEN="your-api-token"
export CONFLUENCE_EMAIL="[email protected]"  # required when using Atlassian Cloud
export CONFLUENCE_API_PATH="/wiki/rest/api"         # Cloud default; use /rest/api for Server/DC
# Optional: set to 'bearer' for self-hosted/Data Center instances
export CONFLUENCE_AUTH_TYPE="basic"

CONFLUENCE_API_PATH defaults to /wiki/rest/api for Atlassian Cloud domains and /rest/api otherwise. Override it when your site lives under a custom reverse proxy or on-premises path. CONFLUENCE_AUTH_TYPE defaults to basic when an email is present and falls back to bearer otherwise.

Getting Your API Token

1. Go to Atlassian Account Settings
2. Click "Create API token"
3. Give it a label (e.g., "confluence-cli")
4. Copy the generated token

Usage

Read a Page

# Read by page ID
confluence read 123456789

# Read in markdown format
confluence read 123456789 --format markdown

# Read by URL (must contain pageId parameter)
confluence read "https://your-domain.atlassian.net/wiki/viewpage.action?pageId=123456789"

Get Page Information

confluence info 123456789

Search Pages

# Basic search
confluence search "search term"

# Limit results
confluence search "search term" --limit 5

List or Download Attachments

# List all attachments on a page
confluence attachments 123456789

# Filter by filename and limit the number returned
confluence attachments 123456789 --pattern "*.png" --limit 5

# Download matching attachments to a directory
confluence attachments 123456789 --pattern "*.png" --download --dest ./downloads

Export a Page with Attachments

# Export page content (markdown by default) and all attachments
confluence export 123456789 --dest ./exports

# Custom content format/filename and attachment filtering
confluence export 123456789 --format html --file content.html --pattern "*.png"

# Skip attachments if you only need the content file
confluence export 123456789 --skip-attachments

List Spaces

confluence spaces

Find a Page by Title

# Find page by title
confluence find "Project Documentation"

# Find page by title in a specific space
confluence find "Project Documentation" --space MYTEAM

Create a New Page

# Create with inline content and markdown format
confluence create "My New Page" SPACEKEY --content "**Hello** World!" --format markdown

# Create from a file
confluence create "Documentation" SPACEKEY --file ./content.md --format markdown

Create a Child Page

# Create child page with inline content
confluence create-child "Meeting Notes" 123456789 --content "This is a child page"

# Create child page from a file
confluence create-child "Tech Specs" 123456789 --file ./specs.md --format markdown

Copy Page Tree

# Copy a page and all its children to a new location
confluence copy-tree 123456789 987654321 "Project Docs (Copy)"

# Copy with maximum depth limit (only 3 levels deep)
confluence copy-tree 123456789 987654321 --max-depth 3

# Exclude pages by title (supports wildcards * and ?; case-insensitive)
confluence copy-tree 123456789 987654321 --exclude "temp*,test*,*draft*"

# Control pacing and naming
confluence copy-tree 123456789 987654321 --delay-ms 150 --copy-suffix " (Backup)"

# Dry run (preview only)
confluence copy-tree 123456789 987654321 --dry-run

# Quiet mode (suppress progress output)
confluence copy-tree 123456789 987654321 --quiet

Notes:

• Preserves the original parent-child hierarchy when copying.
• Continues on errors: failed pages are logged and the copy proceeds.
• Exclude patterns use simple globbing: * matches any sequence, ? matches any single character, and special regex characters are treated literally.
• Large trees may take time; the CLI applies a small delay between sibling page creations to avoid rate limits (configurable via --delay-ms).
• Root title suffix defaults to (Copy); override with --copy-suffix. Child pages keep their original titles.
• Use --fail-on-error to exit non-zero if any page fails to copy.

Update an Existing Page

# Update title only
confluence update 123456789 --title "A Newer Title for the Page"

# Update content only from a string
confluence update 123456789 --content "Updated page content."

# Update content from a file
confluence update 123456789 --file ./updated-content.md --format markdown

# Update both title and content
confluence update 123456789 --title "New Title" --content "And new content"

Edit Workflow

The edit and update commands work together to create a seamless editing workflow.

# 1. Export page content to a file (in Confluence storage format)
confluence edit 123456789 --output ./page-to-edit.xml

# 2. Edit the file with your preferred editor
vim ./page-to-edit.xml

# 3. Update the page with your changes
confluence update 123456789 --file ./page-to-edit.xml --format storage

View Usage Statistics

confluence stats

Commands

Command	Description	Options
init	Initialize CLI configuration
read <pageId_or_url>	Read page content	--format <html|text|markdown>
info <pageId_or_url>	Get page information
search <query>	Search for pages	--limit <number>
spaces	List all available spaces
find <title>	Find a page by its title	--space <spaceKey>
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
update <pageId>	Update a page's title or content	--title <string>, --content <string>, --file <path>, --format <storage|html|markdown>
edit <pageId>	Export page content for editing	--output <file>
stats	View your usage statistics

Examples

# Setup
confluence init

# Read a page as text
confluence read 123456789

# Read a page as HTML
confluence read 123456789 --format html

# Get page details
confluence info 123456789

# Search with limit
confluence search "API documentation" --limit 3

# List all spaces
confluence spaces

# View usage statistics
confluence stats

Development

# Clone the repository
git clone https://github.com/pchuri/confluence-cli.git
cd confluence-cli

# Install dependencies
npm install

# Run locally
npm start -- --help

# Run tests
npm test

# Lint code
npm run lint

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Roadmap

• Create and update pages ✅
• Page templates
• Bulk operations
• Export pages to different formats
• Integration with other Atlassian tools (Jira)
• Page attachments management
• Comments and reviews

Support & Feedback

💬 We'd love to hear from you!

Your feedback helps make confluence-cli better for everyone. Here's how you can share your thoughts:

🐛 Found a bug?

1. Check the Issues page
2. Create a new bug report

💡 Have a feature idea?

1. Create a feature request
2. Join our Discussions to chat with the community

📝 General feedback?

• Share your experience with a feedback issue
• Rate us on NPM
• Star the repo if you find it useful! ⭐

🤝 Want to contribute?

Check out our Contributing Guide - all contributions are welcome!

📈 Usage Analytics

To help us understand how confluence-cli is being used and improve it, we collect anonymous usage statistics. This includes:

• Command usage frequency (no personal data)
• Error patterns (to fix bugs faster)
• Feature adoption metrics

You can opt-out anytime by setting: export CONFLUENCE_CLI_ANALYTICS=false

---

Made with ❤️ for the Confluence community