> [!warning] Raw notes
> These are living, personal config notes — raw, frequently out-of-date, and sometimes half-baked. They reflect my setup at some point in time, not a maintained tutorial. Verify against upstream docs before copying. Reach out if something looks broken.
# Atlassian CLI Configuration
## Overview
`acli` v1.3.13 provides a CLI interface for Jira and Confluence Cloud. Installed via Homebrew at `/opt/homebrew/bin/acli`. Works alongside the Atlassian MCP tools (`mcp__atlassian__*`) as complementary backends.
## Auth Status
| Backend | Jira | Confluence | Notes |
|---------|------|------------|-------|
| acli | Authenticated (OAuth) | Needs `acli confluence auth login` | Browser required for Confluence OAuth |
| Atlassian MCP | Working | Working | Fully functional via MCP server |
## acli Setup
```bash
# Install
brew install atlassian/tap/acli
# Global OAuth (authenticates to site)
acli auth login
# Per-app auth (required for API access)
acli jira auth login # opens browser
acli confluence auth login # opens browser
# Verify
acli auth status
acli jira auth status
acli confluence auth status
```
### Key Commands
```bash
# Jira
acli jira workitem search --assignee=me --status="In Progress" --plain
acli jira workitem view PROJ-123 --plain
acli jira workitem create --project=PROJ --type=Task --summary="Title"
acli jira workitem transition PROJ-123 "Done"
acli jira workitem comment add PROJ-123 "Comment"
# Confluence
acli confluence space list --plain
acli confluence space page search --space=SPACE --query="term"
```
## Atlassian MCP Tools
Available as `mcp__atlassian__*` tools in Claude Code. Key tools:
- `getAccessibleAtlassianResources` — get cloudId (required for all calls)
- `searchJiraIssuesUsingJql` — search Jira with JQL
- `getJiraIssue` / `createJiraIssue` / `editJiraIssue` — CRUD
- `transitionJiraIssue` — move issue status
- `getConfluencePage` / `createConfluencePage` / `updateConfluencePage` — page CRUD
- `searchConfluenceUsingCql` — search Confluence with CQL
## Skill Created
A `/dev:atlassian` skill was added to `claude-marketplace/plugins/dev/` that:
- Auto-detects which backend is available
- Prefers acli when authenticated (faster CLI output)
- Falls back to MCP tools when acli is not auth'd for target app
- Covers: Jira issue CRUD, Confluence page CRUD, search, transitions
Branch: `feat/acli-skill` in claude-marketplace repo.
## TODO
- [ ] Complete Confluence OAuth: run `acli confluence auth login` in a browser-capable terminal
- [ ] Test acli Jira commands against live data