jira-ai

Category: Testing & Security | Uploader: festoinc | Downloads: 0 | Version: v1.0（Latest）

An AI-friendly CLI for Jira designed for maximum efficiency and security.

Changelog: Source: GitHub https://github.com/festoinc/jira-ai

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 publish.yml 664 B
📁 src/
- 📁 commands/
  - 📄 about.ts 893 B
  - 📄 add-comment.ts 2.5 KB
  - 📄 add-label.ts 1.6 KB
  - 📄 auth.ts 6.2 KB
  - 📄 confluence.ts 11.6 KB
  - 📄 create-issue-link.ts 1.7 KB
  - 📄 create-task.ts 4.9 KB
  - 📄 delete-issue-link.ts 2.5 KB
  - 📄 delete-label.ts 1.6 KB
  - 📄 epic.ts 9.7 KB
  - 📄 get-issue-statistics.ts 1.9 KB
  - 📄 get-person-worklog.ts 2.5 KB
  - 📄 issue.ts 1.5 KB
  - 📄 list-colleagues.ts 1.4 KB
  - 📄 list-issue-links.ts 1.3 KB
  - 📄 list-issue-types.ts 1.1 KB
  - 📄 list-link-types.ts 939 B
  - 📄 me.ts 472 B
  - 📄 project-fields.ts 2.7 KB
  - 📄 project-statuses.ts 1.2 KB
  - 📄 projects.ts 1.1 KB
  - 📄 run-jql.ts 819 B
  - 📄 settings.ts 4.0 KB
  - 📄 task-with-details.ts 1.4 KB
  - 📄 transition.ts 2.9 KB
  - 📄 update-description.ts 2.7 KB
  - 📄 update-issue.ts 4.3 KB
- 📁 lib/
  - 📄 adf-mentions.ts 5.0 KB
  - 📄 auth-storage.ts 2.0 KB
  - 📄 confluence-client.ts 12.1 KB
  - 📄 epic-fields.ts 2.6 KB
  - 📄 errors.ts 437 B
  - 📄 field-resolver.ts 3.7 KB
  - 📄 formatters.ts 29.6 KB
  - 📄 jira-client.ts 35.7 KB
  - 📄 json-mode.ts 1.2 KB
  - 📄 settings.ts 11.8 KB
  - 📄 ui.ts 1.2 KB
  - 📄 update-check.ts 3.0 KB
  - 📄 utils.ts 5.3 KB
  - 📄 validation.ts 7.2 KB
- 📁 types/
  - 📄 errors.ts 125 B
  - 📄 marklassian.d.ts 306 B
- 📄 cli.ts 24.8 KB
📁 tests/
- 📁 __mocks__/
  - 📄 jira.js.ts 114 B
  - 📄 marklassian.ts 110 B
  - 📄 mdast-util-from-adf.ts 84 B
  - 📄 mdast-util-to-markdown.ts 77 B
- 📁 e2e/
  - 📄 conftest.py 1.9 KB
  - 📄 test_auth.py 3.0 KB
  - 📄 test_confluence_operations.py 1.5 KB
  - 📄 test_jira_operations.py 6.4 KB
  - 📄 test_no_multi_org.py 3.9 KB
  - 📄 test_settings.py 1.0 KB
- 📁 integration/
  - 📄 create-task.integration.test.ts 1.1 KB
  - 📄 epic.integration.test.ts 5.5 KB
  - 📄 get-users.integration.test.ts 587 B
  - 📄 integration-test-utils.ts 681 B
  - 📄 issue-links.integration.test.ts 4.4 KB
  - 📄 issue.integration.test.ts 1.1 KB
  - 📄 me.integration.test.ts 610 B
  - 📄 project-fields.integration.test.ts 2.9 KB
  - 📄 projects.integration.test.ts 595 B
  - 📄 update-issue.integration.test.ts 3.3 KB
- 📄 about.test.ts 1.7 KB
- 📄 add-comment.test.ts 5.6 KB
- 📄 adf-mentions.test.ts 3.9 KB
- 📄 auth-logout.test.ts 1.6 KB
- 📄 auth-storage.test.ts 3.6 KB
- 📄 auth.test.ts 5.4 KB
- 📄 cli-org-cleanup.test.ts 1.6 KB
- 📄 cli-permissions.test.ts 5.6 KB
- 📄 complex-settings.test.ts 10.2 KB
- 📄 confluence-commands.test.ts 11.3 KB
- 📄 confluence-formatters.test.ts 1.2 KB
- 📄 confluence-search.test.ts 2.4 KB
- 📄 confluence-urls.test.ts 3.7 KB
- 📄 confluence.test.ts 8.5 KB
- 📄 create-task.test.ts 10.4 KB
- 📄 dotenv_output.test.ts 968 B
- 📄 dynamic-help.test.ts 3.7 KB
- 📄 epic-commands.test.ts 10.2 KB
- 📄 epic-fields.test.ts 6.6 KB
- 📄 epic-formatters.test.ts 7.1 KB
- 📄 errors.test.ts 763 B
- 📄 field-resolver.test.ts 7.2 KB
- 📄 formatters.test.ts 19.0 KB
- 📄 get-issue-statistics.test.ts 5.6 KB
- 📄 get-person-worklog.test.ts 6.9 KB
- 📄 get-users.test.ts 2.1 KB
- 📄 help-descriptions.test.ts 1.5 KB
- 📄 issue-100-repro.test.ts 2.0 KB
- 📄 issue-109-repro.test.ts 1.4 KB
- 📄 issue-47-defaults.test.ts 1.5 KB
- 📄 issue-54-comprehensive.test.ts 4.2 KB
- 📄 issue-54-reproduction.test.ts 2.8 KB
- 📄 issue-56-reproduction.test.ts 1.0 KB
- 📄 issue-59-full-breakdown.test.ts 2.0 KB
- 📄 issue-66-reproduction-client.test.ts 1.5 KB
- 📄 issue-66-reproduction.test.ts 2.2 KB
- 📄 issue-83-settings-help.test.ts 847 B
- 📄 issue-86-reproduction.test.ts 2.0 KB
- 📄 issue-87-reproduction.test.ts 1.6 KB
- 📄 issue-95-repro.test.ts 5.4 KB
- 📄 issue-97-repro.test.ts 1.1 KB
- 📄 issue-assign.test.ts 2.5 KB
- 📄 issue-link-client.test.ts 7.5 KB
- 📄 issue-link-commands.test.ts 12.4 KB
- 📄 jira-client.test.ts 30.1 KB
- 📄 json-mode.test.ts 5.4 KB
- 📄 json-output-integration.test.ts 9.6 KB
- 📄 label-commands.test.ts 3.4 KB
- 📄 list-colleagues.test.ts 4.0 KB
- 📄 list-issue-types.test.ts 3.0 KB
- 📄 me.test.ts 2.0 KB
- 📄 non-interactive-auth.test.ts 4.6 KB
- 📄 project-fields.test.ts 6.6 KB
- 📄 project-statuses.test.ts 2.9 KB
- 📄 projects.test.ts 6.3 KB
- 📄 README.md 2.4 KB
- 📄 run-jql.test.ts 4.1 KB
- 📄 service-account-auth.test.ts 8.0 KB
- 📄 settings-command.test.ts 10.4 KB
- 📄 settings.test.ts 14.2 KB
- 📄 single-org-cleanup.test.ts 3.9 KB
- 📄 statistics.test.ts 3.1 KB
- 📄 task-with-details.test.ts 2.8 KB
- 📄 transition.test.ts 2.9 KB
- 📄 ui-json.test.ts 2.5 KB
- 📄 ui.test.ts 1.4 KB
- 📄 update-check.test.ts 4.1 KB
- 📄 update-description.test.ts 6.6 KB
- 📄 update-epic.test.ts 3.2 KB
- 📄 update-issue.test.ts 9.5 KB
- 📄 utils-date.test.ts 1.2 KB
- 📄 utils.test.ts 8.3 KB
- 📄 validation.test.ts 9.3 KB
📁 tests_e2e/
- 📄 test_issue_linking.py 9.1 KB
- 📄 test_json_flag.py 25.5 KB
- 📄 test_rich_issue_create_update.py 18.6 KB
📄 .gitignore 96 B
📄 .npmignore 256 B
📄 advanced-installation.md 982 B
📄 all_avaliable_commands.md 8.0 KB
📄 jest.config.js 737 B
📄 LICENSE 11.1 KB
📄 package-lock.json 124.5 KB
📄 package.json 1.8 KB
📄 README.md 5.5 KB
📄 settings.yaml 578 B
📄 SKILL.md 3.5 KB
📄 starter-installation.md 1.1 KB
📄 tsconfig.json 456 B
📄 vitest.config.ts 227 B

SKILL.md

# Jira AI CLI - AI Agent Skill

An AI-friendly CLI for Jira designed for maximum efficiency and security.

## Why Use Jira AI CLI?
- **Efficiency:** Consumes significantly fewer tokens than Jira MCP or similar tools by eliminating redundant context data.
- **Security:** Bullet-proof security by restricting AI actions to only what you permit.

## Installation & Setup

### General Installation
```bash
npm install -g jira-ai
```

### Authentication
Run interactive authorization:
```bash
jira-ai auth
```
Or use a `.env` file for service accounts:
```bash
jira-ai auth --from-file path/to/.env
```

### Setup Settings & Restrictions
```bash
jira-ai settings --help
```

## JSON Output

All commands support `--json` and `--json-compact` global flags for structured output:

- `jira-ai --json <command>` — pretty-printed JSON
- `jira-ai --json-compact <command>` — single-line JSON (best for token efficiency)

Errors in JSON mode return `{ "error": true, "message": "...", "hints": [...], "exitCode": 1 }` to stdout.

## Command Overview

### Issues
- `issue get <issue-id>`: Retrieve issue details.
- `issue create`: Create a new issue. Supports `--title`, `--project`, `--issue-type`, `--parent` (for subtasks), `--priority`, `--description`, `--description-file`, `--labels`, `--component`, `--fix-version`, `--due-date`, `--assignee`, `--custom-field`.
- `issue search <jql>`: Execute JQL search.
- `issue transition <issue-id> <status>`: Change issue status.
- `issue update <issue-id>`: Update one or more fields of an issue. Supports `--priority`, `--summary`, `--description`, `--from-file`, `--labels`, `--clear-labels`, `--component`, `--fix-version`, `--due-date`, `--assignee`, `--custom-field`.
- `issue comment <issue-id>`: Add comment from Markdown file.
- `issue assign <issue-id> <account-id>`: Assign issue.
- `issue label <add|remove> <issue-id> <labels>`: Manage labels.
- `issue link types`: List all available issue link types.
- `issue link list <issue-key>`: List all links (inward + outward) for an issue.
- `issue link create <source-key> <link-type> <target-key>`: Create a link between two issues (e.g., `"Blocks"`, `"Relates"`).
- `issue link delete <source-key> --target <target-key>`: Delete a link between two issues.

### Projects & Users
- `project list`: List accessible projects.
- `project fields <project-key>`: Discover available fields including custom fields. Use `--type <issue-type>` to filter by issue type, `--custom` for custom fields only, `--search <term>` to search by name.
- `user search [project-key]`: Find users.
- `user worklog <user> <timeframe>`: Get worklogs.

### Epics
- `epic list <project-key>`: List epics in a project (`--done` to include completed, `--max <n>` to limit).
- `epic get <epic-key>`: Get full epic details.
- `epic create <project-key>`: Create a new epic (`--name`, `--summary` required; `--description`, `--labels` optional).
- `epic update <epic-key>`: Update epic name and/or summary.
- `epic issues <epic-key>`: List issues belonging to an epic (`--max <n>` to limit).
- `epic link <issue-key>`: Link an issue to an epic (`--epic <epic-key>`).
- `epic unlink <issue-key>`: Remove an issue from its epic.
- `epic progress <epic-key>`: Show epic completion progress with visual bar.

### Confluence
- `confl get <url>`: Retrieve Confluence page content.
- `confl create <space> <title>`: Create a new page.
- `confl update <url>`: Update page content from Markdown.

For a full list of commands, refer to the [Available Commands](https://github.com/festoinc/jira-ai/blob/main/all_avaliable_commands.md) documentation.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

jira-ai

Directory Structure

SKILL.md

Report

Notice