Extract test cases from automation code and sync them to Jira Xray — without manual copy-pasting!

This open-source CLI tool is developed and maintained by Will Shi @ TMAN Consulting, with the goal of bridging the gap between automated test code and Jira-based test management.

Designed to help teams move faster by connecting code with Jira.

It helps QA and DevOps engineers extract test cases directly from Python, Java, or Robot Framework code and auto-create structured test cases in Jira Xray (both Cloud and Data Center editions).

We’re building a native Jira Cloud plugin, based on this CLI engine but designed for remote Git repositories, no local installation, and seamless integration with GitHub / GitLab / Bitbucket via API.

🎯 No installation. No CLI. Just connect your repo and sync test cases — all inside Jira.

🔔 Sign up for early access: Google Forms

If you find this project helpful:

• 🌟 Please star the repo to support further development
• 👀 Follow the repo or enable “Watch” to get notified about major updates
• 🧪 Try it in your test projects and open issues/feedback
• 📢 Share it with your team or in your community

Your encouragement helps this project (and the upcoming plugin) grow stronger 💪

   ___ ________   ___   ____  ___ ___________  __  ___
  / _ /_  __/ /  / _ | / __/ / _ /_  __/ ___/ /  |/  /__ ____  ___ ____ ____ ____
 / __ |/ / / /__/ __ |_\ \  / __ |/ / / /__  / /|_/ / _ `/ _ \/ _ `/ _ `/ -_) __/
/_/ |_/_/ /____/_/ |_/___/ /_/ |_/_/  \___/ /_/  /_/\_,_/_//_/\_,_/\_, /\__/_/
                                                                  /___/          

• ✅ Auto-detect and parse test cases from Python (pytest, unittest), Java (JUnit-style), or Robot Framework files
• ✅ Create or update corresponding test cases in Jira (Xray) Cloud or Data Center
• ✅ Add source code or docstrings as structured test steps
• ✅ CLI-based, easy to integrate into CI/CD pipelines
• ✅ Configurable via command-line arguments or persistent credential file

• Reduce manual overhead of copying test cases to Jira
• Keep your test documentation and automation always in sync
• Enhance traceability between code and Jira Xray artifacts
• Empower your QA/dev team to focus on testing, not on syncing

We aim to support teams who want:

• Traceability from test code to Jira
• No manual duplication of test cases
• Scalable test management for QA + DevOps

• Python >= 3
• pip (Python package manager)

pip install atlassian-auto-test-case-manager
atlas-atc-manager show-version

Usage: atlas-atc-manager [COMMAND] [OPTIONS]

Commands:
  show-version        display version info for this tool and your Python runtime
  show-variables      show all supported environment variables
  show-config         show config
  config-cred         set and save Jira credentials/config (project, token, etc.)
  extract-case        extract test cases from code and sync them to Jira (Xray, Zephyr Scale, etc.)

Use 'atlas-atc-manager <command> --help' for more info on a specific command.

Usage: atlas-atc-manager extract-case --test-path <TEST_CODE_PATH> [options]

Options:
  --test-path <TEST_CODE_PATH>
                        Path to a test file or folder (supports .py, .java, .robot)
  --jira-plugin <xray>  Target test management tool on Jira : xray
  --jira-project <PROJECT_KEY>
                        Jira project key (e.g. "TEST")
  --jira-hosting <cloud|dc>
                        Jira hosting type (supports cloud, data-center) : cloud | dc
  --jira-site <URL>     Jira site URL (e.g. https://yourcompany.atlassian.net)
  --jira-user <USERNAME>
                        Specify the Jira username for authentication
  --jira-token <TOKEN>  Jira API token for authentication
  --xray-client-id <CLIENT_ID>
                        XRAY Cloud client id for authentication
  --xray-client-secret <CLIENT_SECRET>
                        XRAY Cloud client secret for authentication
  -h, --help            Show this help message and exit

• How to Get Jira Cloud API Token

atlas-atc-manager extract-case \
  --test-path ./tests/ \
  --jira-plugin xray \
  --jira-project QA \
  --jira-hosting dc \
  --jira-site https://jira.mycompany.com \
  --jira-token xxxx-xxxx-xxxx

Save frequently used configuration to a local file (~/.atlas_atc_manager/credential.conf), so you don’t need to pass everything each time.

atlas-atc-manager config-cred --jira-plugin xray --jira-project QA --jira-hosting dc --jira-site https://jira.company.com --jira-token xxxx

Re-run with --overwrite to update.

• Current version supports Xray for Jira Data Center and Xray for Jira Cloud.
• The tool works best in Git-tracked repos, as it uses the repo name to organize test set paths.

Apache License 2.0

LICENSE

• Create XRAY Cloud API Key
• Create Test via XRAY Cloud Graphql REST API