ONEScript Workflow Automation

ONEScript is the scripting layer for ONES. It helps administrators, power users, and developers automate and extend ONES workflows beyond what no-code rules can express.

Use this repository to download ONEScript packages, find the official documentation, and share feedback while ONEScript is in early preview.

What You Can Automate with ONEScript

Use ONEScript when no-code automation is not enough for your workflow logic.

• Update fields, comments, and related data based on work item changes
• Enforce workflow rules before or after users make changes
• Run scheduled jobs and data queries across ONES
• Connect ONES with external systems through REST endpoints
• Migrate Jira ScriptRunner, JMWE, or Power Scripts automation logic to ONES
• Draft scripts with an AI assistant, then validate and test them in ONEScript
• Search issues semantically, send ONES email notifications, and build scheduled follow-up automations
• Validate workflow transitions against registered, estimated, and remaining work

Download ONEScript

Download the latest ONEScript package from Releases.

For the shortest path, use the release links:

• Latest release
• ONEScript v1.1.1 on-premises package: ONEScript-1.1.1-on-prem.opk
• ONEScript v1.1.1 release notes

Install the package through Configuration Center > App management > Uploaded apps. GitHub may also show auto-generated source archives; to install ONEScript, download the .opk package.

What's New in v1.1.1

ONEScript v1.1.1 adds complete worklog support for synchronous workflow guards and advanced record automation.

• Adds issue.worklog for taskPreAction checks against registered, estimated, and remaining hours
• Adds fixed-precision estimate comparisons and platform estimated/remaining roll-ups
• Shares one aggregate read across matching guards while unrelated guards add no request
• Fails closed when required worklog data is unavailable instead of treating it as zero
• Formally supports explicitly separated Simple and Summary worklog record helpers
• Aligns Dry Run, autocomplete, Guide, AI Skill, and the user manual with the runtime contract

Upgrade Notes

After upgrading to v1.1.1:

• Existing v1.1.0 scripts do not require migration.
• Use issue.worklog only in taskPreAction.
• Keep record writes in write-capable L1 triggers.
• Select Simple or Summary helpers from the team's worklog configuration.

Start Here

• Get started
• Install ONEScript
• Write and manage scripts
• Reference
• Migrate Jira scripts to ONES
• Cookbook and resources
• Changelog

Availability

ONEScript v1.1.1 is available for Private / On-Premises deployments. SaaS support is coming soon.

ONEScript is in early preview and intended for evaluation and testing.

Feedback

Share use cases, Jira migration questions, and ideas in Discussions.

Report reproducible issues, installation problems, documentation fixes, and package-related requests in Issues.

Useful Links

• ONEScript documentation
• ONEScript introduction
• ONES Developer docs
• ONES.com