confluence

# Confluence Search and manage Confluence pages using confluence-cli. ## REQUIRED: First-Time Setup Before using this skill, complete these steps: **Step 1: Install the CLI** ```bash npm install -g confluence-cli ``` **Step 2: Get an API token** 1. Go to https://id.atlassian.com/manage-profile/security/api-tokens 2. Click "Create API token" 3. Give it a label (e.g., "confluence-cli") 4. Copy the token **Step 3: Configure the CLI** ```bash confluence init ``` When prompted, enter: - **Domain**: `yourcompany.atlassian.net` (without https://) - **Email**: Your Atlassian account email - **API token**: Paste the token from Step 2 **Step 4: Verify setup** ```bash confluence spaces ``` If you see your spaces listed, you're ready to use Confluence. --- ## Search Pages ```bash confluence search "deployment guide" ``` ## Read Page ```bash confluence read <page-id> ``` Page IDs are in the URL: `https://yoursite.atlassian.net/wiki/spaces/SPACE/pages/123456/Title` → ID is `123456` ## Get Page Info ```bash confluence info <page-id> ``` ## Find Page by Title ```bash confluence find "Page Title" ``` ## List Spaces ```bash confluence spaces ``` ## Create Page ```bash confluence create "Page Title" SPACEKEY --body "Page content here" ``` ## Create Child Page ```bash confluence create-child "Child Page Title" <parent-page-id> --body "Content" ``` Or from a file: ```bash confluence create-child "Page Title" <parent-id> --file content.html --format storage ``` ## Update Page ```bash confluence update <page-id> --body "Updated content" ``` Or from a file: ```bash confluence update <page-id> --file content.html --format storage ``` ## List Child Pages ```bash confluence children <page-id> ``` ## Export Page with Attachments ```bash confluence export <page-id> --output ./exported-page/ ``` ## Tips - Domain in config should NOT include `https://` - just `yourcompany.atlassian.net` - Use `--format storage` when content is in Confluence storage format (HTML-like) - Page IDs are numeric and found in page URLs - Config is stored at `~/.confluence-cli/config.json`