Confluence (atl CLI)
Prerequisites
Before running any Confluence command, verify the CLI is available and authenticated:
- Run
atl --version. If it fails, stop and tell the user: TheatlCLI is not installed. Install it withnpm i -g @ai-foundry/atlassian-bridgeand then runatl auth login. Note:atlis NOT the official Atlassian CLI. It is a community project (@ai-foundry/atlassian-bridge). - Run
atl auth status. If not authenticated, stop and tell the user: You are not logged in. Runatl auth loginto authenticate with your Atlassian account.
Only proceed once both checks pass.
Available Commands
Pages
| Action | Command |
|---|---|
| Get | atl confluence pages get <idOrTitle> [--space <key>] |
| Create | atl confluence pages create <title> --space <id> [--parent <id>] [--body <adf>] |
| Update | atl confluence pages update <pageId> [--title <title>] [--body <adf>] [--parent <id>] |
| Delete | atl confluence pages delete <pageId> |
| Search | atl confluence pages search <cql> [--limit <n>] [--cursor <token>] |
| Children | atl confluence pages children <idOrTitle> [--space <key>] [--depth <n>] |
Spaces
| Action | Command |
|---|---|
| Get | atl confluence spaces get <idOrKey> |
| Tree | atl confluence spaces tree <idOrKey> [--depth <n>] |
Guidelines
- When the user provides a page title instead of an ID, use the title directly — the CLI resolves it. Include
--spaceif the user specifies or if disambiguation is needed. - For search, build a valid CQL query from the user's intent (e.g.
type=page AND title~"design doc"). - When creating or updating pages with
--body, the value must be valid ADF (Atlassian Document Format) JSON. - Always show the user the command you are about to run before executing it.