Atlassian Bridge

A CLI for managing Jira and Confluence from the terminal. Hand-rolled command framework with Zod as the only runtime dependency.

Prerequisites

• Node.js >= 22.12

Installation

npm i -g @ai-foundry/atlassian-bridge

Authentication

Credentials can be stored locally or provided via environment variables.

Login

atl auth login --base-url https://yoursite.atlassian.net --email [email protected] --token YOUR_TOKEN

Environment variables

| Variable | Description | | --------------------- | --------------------------------------------------------------------------------------- | | ATLASSIAN_BASE_URL | Atlassian instance URL | | ATLASSIAN_EMAIL | Account email | | ATLASSIAN_API_TOKEN | API token (generate one) |

Other auth commands

atl auth status    # Show current credentials
atl auth logout    # Remove stored credentials

Upgrading

atl pkg upgrade

Usage

# Jira
atl jira issues search "project = PROJ"
atl jira issues get PROJ-123
atl jira issues create "Fix login bug" --project PROJ --type Bug
atl jira projects list

# Confluence
atl confluence pages search "space = DEV"
atl confluence pages get "My Page Title" --space DEV
atl confluence pages children 12345
atl confluence spaces tree SPACEKEY

Commands

atl auth login|status|logout

atl pkg upgrade

atl jira issues get <issueKey>
atl jira issues create <summary> --project <key> --type <name> [--description <adf>] [--parent <key>] [--labels <csv>]
atl jira issues update <issueKey> [--summary] [--description] [--parent] [--labels] [--status]
atl jira issues delete <issueKey>
atl jira issues search <jql> [--limit] [--cursor] [--fields]
atl jira issues children <issueKey>

atl jira attachments list <issueKey>
atl jira attachments get <attachmentId>

atl jira comments list <issueKey> [--limit] [--cursor]
atl jira comments get <commentId> --issue <issueKey>
atl jira comments add <issueKey> --body <adf>
atl jira comments update <commentId> --issue <issueKey> --body <adf>
atl jira comments delete <commentId> --issue <issueKey>

atl jira projects get <keyOrId>
atl jira projects list [--limit] [--cursor] [--query]

atl confluence pages get <idOrTitle> [--space]
atl confluence pages create <title> --space <id> [--parent <id>] [--body <adf>]
atl confluence pages update <pageId> [--title] [--body] [--parent]
atl confluence pages delete <pageId>
atl confluence pages search <cql> [--limit] [--cursor]
atl confluence pages children <idOrTitle> [--space] [--depth]

atl confluence spaces get <idOrKey>
atl confluence spaces tree <idOrKey> [--depth]

Global flags: --help, --version, -v/--verbose

Available Skills

Agent skills that let your AI agent interact with Jira and Confluence directly.

| Skill | Install | | -------------- | -------------------------------------------------------- | | Jira | npx skills add adrianhdezm/atlassian-bridge jira | | Confluence | npx skills add adrianhdezm/atlassian-bridge confluence |

Development

Prerequisites

• Node.js >= 22.12
• pnpm

Setup

pnpm install

Scripts

pnpm dev       # Run CLI in dev mode (tsx)
pnpm build     # Compile TypeScript to dist/
pnpm test      # Run all tests
pnpm lint      # Lint with ESLint
pnpm format    # Format with Prettier

Running in dev mode

In dev mode, use pnpm dev instead of atl:

pnpm dev auth login --base-url https://yoursite.atlassian.net --email [email protected] --token YOUR_TOKEN
pnpm dev jira issues search "project = PROJ"

License

MIT