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`