Command reference

Enter help to list all commands, or help <command> for help with a specific command. Enter help | for help with pipes, and help ^ for caret substitution.

For end-to-end recipes, see Use cases.

Navigation

• ls / ls -l / ls --format csv — list spaces, pages, or folders (-l columns; CSV for machine-readable)
• cd — change directory (cd with no path returns to /; folders are valid path segments)
• pwd — print working directory

Discover

• find — recursively list page/folder paths; -name / -maxdepth / -mtime / -label / -prune; -ls / --format csv; -exec grep searches page bodies
• tree — ASCII page/folder tree under PATH; -L / --maxdepth (default depth 3)
• du — sum attachment sizes under a page, space, or folder

Move / copy / delete / archive / labels

• mv — rename or move one or more pages; glob on source argv; -n / --dry-run; cross-space needs -y; pipe path lines as sources
• cp — copy one or more pages; cp -r copies a page tree (max 200 pages; DEST may be in another space); glob on source argv; -n / --dry-run; pipe path lines as sources
• rm / del — delete pages (or one space) to trash; several paths, globs, or a pipe (max 100; requires -y / --yes)
• archive — send pages to Confluence native archive (Standard+; not Free; max 100; requires -y)
• label — list, add, or remove page labels; pipe from find; pair with find -label
• touch / mkdir — create an empty page

Page restrictions

• chmod — list or change explicit Confluence page restrictions (view / edit) for users and groups. Not Unix modes (no 755). No chown in this release. Dry-run: -n. Writes require -y. clear removes explicit restrictions on that page. No space-level permissions; no -R.

Inspect

• cat — show page body
• open — open in a new tab
• head / tail — first or last N lines (page path or pipe)
• less — page through a page or piped output
• grep — filter lines
• wc — line count (wc / wc -l)
• sort — sort lines (sort / sort -r)
• echo — print arguments or pass piped input through
• checkout / restore — list versions or restore (restore requires -y)

Attachments

• attach — attach ls, attach find (recursive inventory; -size / -mtime / -name / -ls / CSV), attach rm -y, attach mv -y (trash only; no upload)

Shortcuts, help, theme, screen

• alias / unalias — shortcuts stored in this browser
• help
• Theme — theme, theme list, theme NAME; theme font / theme size / theme height
• clear

Pipes

$ ls | grep -i page
$ cat ./page1 | head
$ ls | tail 2
$ find ./folder -name 'Draft*' | mv ./Archive
$ find ./folder | grep Draft | cp ./Archive
$ find ./MySpace -mtime +365 -prune | label add needs-review -y
$ find ./MySpace -mtime +730 -prune | archive -n
$ find ./folder | rm -n
$ attach find /DOCS -size +10M | attach rm -n

You can also pass a page path directly to head, tail, grep, wc, or sort.

touch, mkdir, cd, open, checkout, and restore do not consume piped stdin. mv, cp, rm, archive, label, chmod, and attach rm do when you pipe path lists.

Caret substitution

$ cat debug-2025-10-23
$ ^cat^open

Re-runs the previous command with the first OLD replaced by NEW. Enter help ^ for details.

Try it

• Shell for Confluence on Marketplace