_   _      _ _
   __ _ | |_| | ___| (_)
  / _` || __| |/ __| | |
 | (_| || |_| | (__| | |
  \__,_| \__|_|\___|_|_|

  Extensible CLI for Atlassian products

atlcli

A blazingly fast CLI for Atlassian products. Sync Confluence pages as markdown, manage Jira issues from your terminal.

Key Features

Confluence

• Bidirectional markdown sync with conflict detection
• Macro support (info, note, warning, expand, toc)
• Page templates with Handlebars-style variables
• Attachment sync with smart change detection

Jira

• Full issue lifecycle from the command line
• JQL search with convenient shortcuts
• Sprint analytics (velocity, burndown, predictability)
• Timer-based time tracking
• Issue templates for quick reuse

General

• Multiple auth profiles
• Plugin system for extensibility
• Comprehensive JSONL logging

Installation

Quick Install (macOS/Linux)

curl -fsSL https://atlcli.sh/install.sh | bash

Homebrew

brew install bjoernschotte/tap/atlcli

From Source

git clone https://github.com/BjoernSchotte/atlcli.git
cd atlcli
bun install && bun run build

Requirements

• macOS, Linux, or WSL (Windows native not supported)
• Atlassian Cloud instance (Server/Data Center not supported)
• API token from id.atlassian.com

See Getting Started for detailed setup instructions.

Quick Example

# Authenticate
atlcli auth init

# Sync Confluence docs
atlcli wiki docs init ./my-docs --space TEAM
atlcli wiki docs pull ./my-docs
# Edit locally...
atlcli wiki docs push ./my-docs

# Search Jira issues
atlcli jira search --assignee me --status "In Progress"

# Track time on an issue
atlcli jira worklog timer start PROJ-123
# ... work ...
atlcli jira worklog timer stop PROJ-123

Documentation

Full documentation: https://atlcli.sh/

• Getting Started
• Confluence Guide
• Jira Guide
• CLI Reference
• Plugin Development
• Contributing
• Changelog

Development

bun install        # Install dependencies
bun run build      # Build all packages
bun run start      # Run development version
bun test           # Run tests

See Contributing Guide for detailed development setup.

Project Structure

atlcli/
├── apps/
│   ├── cli/              # CLI entry point and commands
│   └── uno-dashboard/    # UNO dashboard web app
├── packages/
│   ├── core/             # Shared utilities (config, logging, templates)
│   ├── confluence/       # Confluence API client + markdown conversion
│   ├── jira/             # Jira API client
│   ├── export/           # PDF/Word export (Python)
│   └── plugin-api/       # Plugin type definitions
├── plugins/              # Built-in plugins (git, example)
├── scripts/              # Build and release scripts
├── services/             # Background services (UNO)
├── spec/                 # Feature specifications
└── src/content/docs/     # Documentation (Astro Starlight)

License

MIT - see LICENSE

---

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.