Skip to main content
Make hosted workflow source code public through Libretto Cloud.
The cloud share command creates a public code share for a workflow that is already deployed to Libretto Cloud. Use it when you want anyone with the generated URL to fork your automation code and use it as the starting point for their own automation.
Workflow sharing requires a Libretto Cloud account, API key, and tenant-level code sharing. Code sharing is disabled by default for new tenants. If you have not set up Libretto Cloud yet, start with Libretto Cloud Hosting.

​
cloud share

npx libretto cloud share check-eligibility

​
Syntax

npx libretto cloud share <workflow> [flags]
​
workflow
string
required
The hosted workflow name to share. This is the workflow name declared in code and deployed with npx libretto cloud deploy.
​
--refresh
boolean
Refresh an existing share from the workflow’s current deployment.

​
Prerequisites

1

Create a Libretto Cloud account

Sign up for Libretto Cloud before sharing workflows:
npx libretto cloud auth signup
See Libretto Cloud Hosting for the full hosted setup flow.
2

Issue an API key

Create an API key and expose it as LIBRETTO_API_KEY:
npx libretto cloud auth api-key issue --label laptop-dev
export LIBRETTO_API_KEY=<issued-key>
3

Enable code sharing

Code sharing is disabled by default for each tenant. Enable it before creating public workflow links:
npx libretto cloud sharing enable
4

Deploy the workflow

Share works on hosted workflows. Deploy the package that contains the workflow before sharing it:
npx libretto cloud deploy .

​
Output

When sharing succeeds, Libretto prints the public marketplace URL and code URL: 
Shared workflow: check-eligibility
Marketplace URL: https://libretto.sh/...
Code URL: https://libretto.sh/...
If the workflow is already shared, rerun the command with --refresh to update the shared code from the current deployment: 
npx libretto cloud share check-eligibility --refresh

​
cloud sharing

Use the cloud sharing commands to inspect or change whether public workflow code sharing is enabled for the current Libretto Cloud tenant. New tenants start with code sharing disabled. 
npx libretto cloud sharing status
npx libretto cloud sharing enable
npx libretto cloud sharing disable
All cloud sharing commands require LIBRETTO_API_KEY.
Shared workflow code is public. Review the deployed source before sharing, and keep credentials in Libretto Cloud credentials or environment configuration instead of hard-coding them in workflow files.