confluence-cli

Capabilities

One CLI for the whole wiki

Read, search and edit Confluence — with output a coding agent can act on.

Focused page reads

Pull a whole page, or just an outline, one section or keyword matches — an agent loads only the context it needs.

Create & edit pages

Create, update, delete, move and copy pages. Author in Markdown — it converts to storage format — and preview any write with --dry-run.

CQL search

Query with raw CQL, or build one from filter flags: text, author, space, label, type and date ranges.

Comments & threads

Read footer comments and post replies, threaded under any parent comment.

Multiple serversnew

kubectl-style named contexts in one config file. Switch the current server, or override per command with --use-context.

Agent-first output

JSON by default, with structured errors — categories, exit codes and recovery hints a coding agent can branch on.

Secure credentials

Tokens live in the OS keychain, with a 0600 file fallback — never in the config file.

Cloud & Data Center

One flavor-agnostic client; the backend — Cloud or Data Center / Server — is detected automatically.

Install

Up and running in a minute

Pick whichever method suits you — or grab a prebuilt binary.

install

# npm
npm install -g @angelmsger/confluence-cli

# go
go install github.com/angelmsger/confluence-cli/cmd/confluence-cli@latest

# from source
make install

Prefer a binary? Download one from the Releases page.

Shell completion

Completes subcommands, flag values and live space keys. Load it once:

$ source <(confluence-cli completion bash)

Companion Skill

A confluence Skill is embedded in the binary. It detects your coding agent — Claude Code, Codex — and installs for each:

$ confluence-cli skill install

Quick start

Configure once, then work the wiki

Set up a server, then read and write from the terminal.

a typical session

# interactive TUI setup, then verify connectivity
$ confluence-cli config init --pretty
$ confluence-cli doctor

# find a page, then read it in stages
$ confluence-cli search --text "release process"
$ confluence-cli page get <id|url> --scope outline
$ confluence-cli page get <id|url> --scope section --section sec-2

# create a page from Markdown, preview before sending
$ confluence-cli page create --space ENG --title "Release Notes" \
    --format markdown --body-file notes.md --dry-run