atl-confluence

atl — Confluence Commands

Quick start

# Search pages
atl confluence search "deployment guide"

# Read a page
atl confluence get-page --id 12345

# Create a page
atl confluence create-page --space DEV --title "New Guide" --body "# Hello\n\nContent here"

# Update a page
atl confluence update-page --id 12345 --body "# Updated content"

# Add a comment
atl confluence add-comment "Looks good!" --page-id 12345

---

atl confluence search <query>

Search Confluence pages. Accepts plain text (auto-converted to CQL) or raw CQL queries.

atl confluence search "<query>" [--limit N] [--offset N] [--spaces SPACE1,SPACE2] [--json]

Options:

• --limit N (default: 10) — max results
• --offset N (default: 0) — skip N results
• --spaces — comma-separated space keys to filter
• --json — force JSON output

Examples:

atl confluence search "deployment guide"
atl confluence search "type = page AND space = DEV AND title ~ 'API'"
atl confluence search "architecture" --spaces DEV,PLATFORM

JSON output:

{
  "results": [
    {
      "id": "12345",
      "title": "Page Title",
      "type": "page",
      "spaceKey": "DEV",
      "spaceName": "Development",
      "lastModified": "2024-01-16T14:20:00.000Z",
      "excerpt": "Matching excerpt...",
      "url": "https://company.atlassian.net/wiki/spaces/DEV/pages/12345"
    }
  ],
  "total": 15,
  "hasMore": true
}

---

atl confluence get-page

Get full page content, converted to layout-aware markdown. Handles multi-column layouts, code blocks, panels, expand sections, and embedded images.

atl confluence get-page --id <PAGE_ID> [--raw] [--json]
atl confluence get-page --title "<title>" --space <KEY> [--raw] [--json]

Options:

• --id — page ID (numeric)
• --title — page title (requires --space)
• --space — space key (requires --title)
• --raw — return raw HTML instead of markdown
• --json — force JSON output

Examples:

atl confluence get-page --id 12345
atl confluence get-page --title "API Documentation" --space DEV