confluence-cliInteract with Confluence Cloud from the command line. Use when reading, creating, updating, or searching Confluence pages, managing attachments, labels, comments, or exporting content.
Install via ClawdBot CLI:
clawdbot install hochej/confluence-cliCLI for Confluence Cloud.
Check if confcli is installed:
command -v confcli
If not installed, install via:
curl -fsSL https://raw.githubusercontent.com/hochej/confcli/main/install.sh | sh
To install a specific version or to a custom directory:
curl -fsSL https://raw.githubusercontent.com/hochej/confcli/main/install.sh | VERSION=0.2.3 sh
curl -fsSL https://raw.githubusercontent.com/hochej/confcli/main/install.sh | INSTALL_DIR=~/.bin sh
Check auth status first:
confcli auth status
If not authenticated, ask the user to configure authentication. They can either:
confcli auth login interactively in their own terminal, orCONFLUENCE_DOMAIN — e.g. yourcompany.atlassian.netCONFLUENCE_EMAILCONFLUENCE_TOKEN (or CONFLUENCE_API_TOKEN)API tokens are generated at
https://id.atlassian.com/manage-profile/security/api-tokens
Never ask the user to paste a token into the conversation. Tokens must be
set via environment variables or confcli auth login.
Pages can be referenced by:
12345https://company.atlassian.net/wiki/spaces/MFS/pages/12345/TitleMFS:OverviewWrite operations (create, update, delete, purge, edit, label add/remove,
attachment upload/delete, comment add/delete, copy-tree) require explicit user
intent. Never perform these based on assumptions.
Use --dry-run to preview destructive operations without executing them.
# Spaces
confcli space list
confcli space get MFS
confcli space pages MFS --tree
confcli space create --key PROJ --name "Project" -o json --compact-json
confcli space delete MFS --yes
# Pages
confcli page list --space MFS --title "Overview"
confcli page get MFS:Overview # metadata (table)
confcli page get MFS:Overview --show-body # include body in table output
confcli page get MFS:Overview -o json # full JSON
confcli page body MFS:Overview # markdown content
confcli page body MFS:Overview --format storage
confcli page children MFS:Overview
confcli page children MFS:Overview --recursive
confcli page history MFS:Overview
confcli page open MFS:Overview # open in browser
confcli page edit MFS:Overview # edit in $EDITOR
# Search
confcli search "query"
confcli search "type=page AND title ~ Template"
confcli search "confluence" --space MFS
# Write
confcli page create --space MFS --title "Title" --body "<p>content</p>"
confcli page update MFS:Overview --body-file content.html
confcli page delete 12345
# Attachments
confcli attachment list MFS:Overview
confcli attachment upload MFS:Overview ./file.png ./other.pdf
confcli attachment download att12345 --dest file.png
# Labels
confcli label add MFS:Overview tag1 tag2 tag3
confcli label remove MFS:Overview tag1 tag2
confcli label pages "tag"
# Comments
confcli comment list MFS:Overview
confcli comment add MFS:Overview --body "LGTM"
confcli comment delete 123456
# Export
confcli export MFS:Overview --dest ./exports --format md
# Copy Tree
confcli copy-tree MFS:Overview MFS:TargetParent
Use -o flag: json, table, md
confcli space list -o json
confcli page get MFS:Overview -o json
Add --all to fetch all results, -n to set limit:
confcli space list --all
confcli search "query" --all -n 100
Generated Mar 1, 2026
A software development team uses confcli to automate the creation and updating of technical documentation in Confluence. They script the generation of release notes and API documentation, ensuring consistency and reducing manual effort. This is particularly useful in agile environments where documentation needs to keep pace with rapid development cycles.
A project management office employs confcli to generate weekly status reports by pulling data from Confluence pages and compiling them into structured formats. This automates the aggregation of updates from multiple teams, saving time and minimizing errors in reporting. It supports compliance and stakeholder communication in regulated industries.
An organization undergoing a Confluence migration uses confcli to export pages and attachments to markdown or JSON formats for backup or transfer to another system. This ensures data integrity and facilitates smooth transitions during IT infrastructure changes. It is critical for business continuity and data governance.
A financial services firm utilizes confcli to automate the retrieval of page histories and labels for audit purposes. This helps in tracking changes to critical documents, ensuring regulatory compliance, and generating audit trails without manual intervention. It reduces risk and supports legal requirements.
A customer support team leverages confcli to search and update Confluence knowledge base articles based on common queries. This allows for quick content revisions and tagging, improving the accuracy and accessibility of support resources. It enhances customer satisfaction and operational efficiency.
Offer confcli as a free, open-source tool to build a user community, while providing paid support, customization, and training services. This model attracts enterprises needing reliable assistance and tailored solutions, generating revenue through service contracts. It balances accessibility with sustainable income.
Develop a cloud-based platform that integrates confcli with other tools like CI/CD pipelines or project management software, offering enhanced features and automation. Charge subscription fees based on usage tiers or number of users. This model targets tech-savvy teams looking for streamlined workflows.
License confcli to large organizations with advanced security and compliance requirements, bundled with consulting services for implementation and optimization. Revenue comes from one-time license fees and ongoing consulting engagements. This model caters to industries with strict data governance needs.
💬 Integration Tip
Integrate confcli into CI/CD pipelines using environment variables for authentication, automating documentation updates with each code deployment. Ensure to use --dry-run flags in scripts to preview changes and avoid unintended modifications.
Manage torrents with qBittorrent. Use when the user asks to "list torrents", "add torrent", "pause torrent", "resume torrent", "delete torrent", "check download status", "torrent speed", "qBittorrent stats", or mentions qBittorrent/qbit torrent management.
Search indexers and manage Prowlarr. Use when the user asks to "search for a torrent", "search indexers", "find a release", "check indexer status", "list indexers", "prowlarr search", "sync indexers", or mentions Prowlarr/indexer management.
Interact with Uptime Kuma monitoring server. Use for checking monitor status, adding/removing monitors, pausing/resuming checks, viewing heartbeat history. Triggers on mentions of Uptime Kuma, server monitoring, uptime checks, or service health monitoring.
Backup Clawdbot workspace and config to GitHub with git-crypt encryption. Use for daily automated backups or manual backup/restore operations.
Query and monitor Unraid servers via the GraphQL API. Use when the user asks to 'check Unraid', 'monitor Unraid', 'Unraid API', 'get Unraid status', 'check disk temperatures', 'read Unraid logs', 'list Unraid shares', 'Unraid array status', 'Unraid containers', 'Unraid VMs', or mentions Unraid system monitoring, disk health, parity checks, or server status.
Manage TrueNAS SCALE via API. Check pool health, manage datasets and snapshots, monitor alerts, control services, manage apps, orchestrate Dockge container stacks, and manage bookmarks. Use when the user asks about their NAS, storage, backups, containers, bookmarks, or homelab services.