atlcli

Confluence and Jira in your terminal, your browser and your CI pipeline.

Browse and edit Jira issues and Confluence pages in a fullscreen terminal UI, run boards and sprints from the command line, keep Confluence spaces as Markdown in Git, and export pages and page trees to publication-grade PDF and Word — from the CLI or locally in a Chrome side panel.

Quick install | Terminal UI | PDF and Word | In your browser | Jira | Confluence as code | Confluence as a filesystem | Web publishing | Automation scripts | Scripts, CI and agents | Agent skill | Install | Documentation | Development | License

Quick install

brew install bjoernschotte/tap/atlcli        # or: curl -fsSL https://atlcli.sh/install.sh | bash
atlcli auth init                             # connect your Atlassian site
atlcli tui                                   # Jira and Confluence, fullscreen

Prebuilt for macOS, Linux and Windows. Manual downloads, checksums and the development channel: Install.

Jira in the terminal	Confluence in the terminal
Every change shows a diff first	Publication-grade PDF

Terminal UI

atlcli tui opens Jira and Confluence side by side in one fullscreen terminal: a navigator, a list and a detail pane, with the keyboard or the mouse.

• Jira: your open issues, boards with their sprints and backlog, epics and favourite filters. Filter with jira search flags or JQL, sort, mark issues for bulk changes. Transition, assign, comment, edit in $EDITOR, label, move to a sprint, set the epic, create and clone.
• Agile: see a sprint as a board and move cards across its columns; create boards and sprints from the navigator, start and complete sprints, and reorder the backlog with R.
• Confluence: spaces and their page trees, CQL search, every page as the same Markdown wiki docs pull writes. Edit in $EDITOR, add child pages, labels, move pages, compare versions.
• Safe by design: every write lists what it changes and asks first; a page someone saved meanwhile is never overwritten.
• Learn the CLI as you go: ! lists every change you made as the atlcli command that does the same, ready to paste into a script.
• Yours: ? shows the keys of the focused pane, : finds every command by name; saved views, lists that refresh while you look, light and dark themes, configurable keys and columns.

The active sprint, with comments	One palette for every command

Explore the terminal UI →

Publication-grade PDF and Word

atlcli does not print a web page or flatten Confluence into a screenshot. It interprets the document and writes real, structured PDF and Word files — one page, a page tree or a whole space in a single document.

Images remain sharp, color-managed document content — not browser screenshots.

Mermaid, Expand, and Shiki code	Dense tables keep every value, link and badge

• Real Confluence content — layouts, panels, status badges, mentions, Smart Links, task lists, inline comments, attachments and emoji keep their meaning.
• Tables that fit — authored widths, merged cells and repeated header rows; dense tables scale deterministically instead of being clipped.
• Macros, diagrams and charts — TOC, Expand, Jira issue tables, Draw.io and Gliffy; Mermaid and Confluence charts as vector graphics from their real data.
• Tagged PDFs, native Word — a Typst engine writes tagged PDFs with bookmarks, embedded fonts and alt text; Word files use native TOC fields, comments and sections, from your own templates.
• No silent content loss — anything that cannot render falls back visibly, and the export report lists what rendered, degraded or was skipped.

atlcli wiki export 12345 --scope tree --output handbook.pdf

Open the nine-page PDF fidelity reference → · Explore DOCX and PDF export →

In your browser

The atlcli Chrome extension exports the Confluence Cloud page you are reading to Word or PDF in a side panel — with the session you are already signed in with, no API token needed.

• Local by design: the PDF compiler, fonts and export engines ship inside the extension. Page content never goes to an external rendering service.
• Preview and brand: preview the PDF before you download it, and keep document branding and template sets per space.
• Leave it running: exports continue in the background when you close the panel or navigate away, and resume after a browser restart. The Activity view shows every job, with retry and Resume after sign-in.

The extension installs from the release ZIP and needs Chrome 140 or newer.

Use the CLI when you need…	Use the extension when you need…
Repeatable, scriptable exports	A one-off export of the page you are viewing
CI and headless automation	A PDF preview before download
JSON reports and classified exit codes	Visual PDF settings and branding
Cloud or Data Center	Your existing Confluence Cloud session

Explore the browser extension →

Jira from the command line

atlcli jira search --assignee me --status "In Progress"
atlcli jira issue create --project TEAM --type Task --summary "Rotate CI tokens" --edit
atlcli jira board create --name "Team board" --project TEAM
atlcli jira sprint start --id 42 --end 2026-11-07
atlcli jira issue rank TEAM-7 TEAM-8 --before TEAM-1
atlcli jira bulk move --jql "project = TEAM AND labels = q4" --sprint 42 --dry-run

Issues, comments, links and attachments; boards, sprints, backlog, epics and ranking; bulk changes with dry runs; issue templates; flow analytics and sprint reports; timer-based time tracking.

Explore Jira workflows →

Confluence as code

Pull a space into a Markdown workspace, edit it with your usual tools, and push it back with conflict detection. Page hierarchy, attachments, macros, labels and frontmatter stay part of the workflow.

atlcli wiki docs init ./team-docs --space TEAM
cd team-docs && atlcli wiki docs pull
atlcli wiki docs status
atlcli wiki docs push --validate

Explore Confluence workflows →

Confluence as a filesystem

Spaces are directories, pages are directories with an _index.md, and ls, cat, grep and sed work on them — in a shell, or as a mounted volume. No MCP server, no tool calls.

atlcli wiki sh --space DOCS -c 'grep -rlw kubernetes . | head -5'
atlcli wiki mount ~/confluence --space DOCS

It is a cache, not a copy: only what you read reaches the disk. Writing is off by default (--mode rw enables it), and deletion always goes to the trash.

Explore the virtual filesystem →

Static web publishing

Build a page tree or a space into a verified static Astro site, with Starlight or a plain Astro render kit and local Pagefind search.

atlcli wiki publish run --project .atlcli/publish.json --profile work

Explore Astro web publishing →

Automation scripts

Write Jira and Confluence automation as a few lines of TypeScript. No imports, no setup: atlcli.* is always there, and the script runs in a sandbox without file system or network access.

for await (const issue of atlcli.jira.search("project = TEAM AND updated < -180d")) {
  await atlcli.jira.comment(issue.key, "Closing as stale");
  await atlcli.jira.transition(issue.key, "Won't Do");
}

atlcli script run stale.ts                        # dry run: prints the plan, changes nothing
atlcli script run stale.ts --plan-out plan.json   # review it, e.g. as a CI artifact
atlcli script apply plan.json                     # apply exactly that plan

Every write is planned first. Applying checks that nothing changed in the meantime, and writes nothing if something did. Updates that would change nothing are left out, so a re-run of a finished script plans nothing.

Area	What scripts can do
Jira issues	search, read, create, update, transition, comment, link, assign by name or email, labels, attachments
Jira agile	list boards and sprints, create, start and close sprints, move issues into a sprint
Confluence pages	search, read as Markdown, create, update, upsert by title, move, delete to the trash
Around pages	labels, comments, attachments, PDF and DOCX export

export const meta = { permissions: [...] } limits a shared or AI-generated script to the projects and spaces it names.

Explore automation scripts →

Built for scripts, CI and agents

• Human-readable output by default, stable --json for scripts
• Validation and strict modes, classified exit codes and export reports for CI
• Named profiles for several Atlassian sites, Cloud and Data Center
• atlcli doctor checks configuration, credentials and permissions
• Bash and Zsh completion, and a plugin system

Workflow	Start here
Browse Jira and Confluence	atlcli tui
Search and manage Jira	atlcli jira --help
Sync Confluence and Markdown	atlcli wiki docs --help
Work on Confluence with a shell	atlcli wiki sh --help
Export DOCX or PDF	atlcli wiki export --help
Automate with TypeScript	atlcli script init
Diagnose configuration	atlcli doctor
Teach an agent atlcli	atlcli skill --install .claude/skills

Agent skill

atlcli ships an agent skill that teaches a coding agent the CLI: the flag grammar, JSON output and error codes, and the rule to confirm every write with the user. It lives in skills/atlcli/, and every binary carries a copy:

atlcli skill --install .claude/skills   # writes .claude/skills/atlcli/

See Agent Skill and Confluence for Coding Agents.

Install

# macOS or Linux
curl -fsSL https://atlcli.sh/install.sh | bash

# Homebrew
brew install bjoernschotte/tap/atlcli

# A green-main development build instead (conflicts with the stable formula)
brew install bjoernschotte/tap/atlcli-dev

Then connect a site and check it:

atlcli auth init
atlcli doctor

Windows binaries, manual downloads, checksums and the packaged extension are in the installation guide and Development releases.

Documentation

The complete documentation lives at atlcli.sh: Getting started · Authentication · Terminal UI · Confluence · DOCX and PDF export · Jira · Automation scripts · Recipes · CLI reference · Troubleshooting

Development

atlcli is a Bun workspace monorepo.

bun install
bun run build
bun run test
bun run typecheck
bun --conditions=development run --cwd apps/cli src/index.ts --help   # the CLI from source

The README screenshots come from scripts/readme/ (demo content on a test site, then the real TUI in tmux). See the contributing guide for structure, testing, documentation and releases.

License

Licensed under the Apache License 2.0. See NOTICE for additional attribution.

Jira and Confluence are trademarks of Atlassian Corporation Plc, registered in the US and other countries. atlcli is not affiliated with, endorsed by, or sponsored by Atlassian.