Guides
Publishing Workflows

Publishing Workflows

Share your workflows with the Hydra community.

Overview

Publishing makes your workflow available in the Hydra Marketplace where others can discover, fork, and subscribe to it.

Before Publishing

Checklist

  • Workflow has a clear, descriptive name
  • Intent explains what the workflow accomplishes
  • All steps have meaningful names and IDs
  • Context fields are documented
  • Tested with at least one IDE adapter
  • No sensitive data (API keys, passwords, etc.)

Best Practices

  1. Write a good intent - Users search by intent
  2. Add relevant tags - Helps discoverability
  3. Choose the right category - Development, DevOps, Testing, etc.
  4. Include documentation - Add a README in the description

Publishing Steps

1. Open Your Workflow

Navigate to Dashboard → Workflows → Your Workflow

2. Set Visibility to Public

  1. Click Settings (gear icon)
  2. Change Visibility from "Private" to "Public"
  3. Confirm the change

3. Add Metadata

Fill in the publishing details:

FieldDescriptionExample
CategoryWorkflow categoryDevelopment
TagsSearch keywordsbug-fix, testing, typescript
DescriptionDetailed descriptionFull markdown supported

4. Review and Publish

  1. Click Preview to see how it will appear in the Marketplace
  2. Click Publish to make it live

Marketplace Visibility

Once published, your workflow appears in:

  • Browse - Listed in the relevant category
  • Search - Searchable by name, intent, tags
  • Featured - May be featured if highly rated

Versioning

Creating Versions

When you update a published workflow:

  1. Make your changes
  2. Click Publish New Version
  3. Add a changelog entry
  4. Choose version number (semver)
v1.0.0 → v1.1.0  (minor update)
v1.1.0 → v2.0.0  (breaking change)

Version History

Users can see your version history:

v2.0.0 - Added parallel execution support
v1.1.0 - Fixed edge case in analysis step
v1.0.0 - Initial release

Subscriber Updates

When you publish a new version:

  • latest subscribers - Get the update automatically
  • ^1.x subscribers - Get minor updates
  • ~1.0.x subscribers - Get patch updates only
  • Exact version - No automatic updates

Breaking changes (major versions) require subscribers to explicitly update.

Unpublishing

To remove a workflow from the Marketplace:

  1. Go to Workflow Settings
  2. Click Unpublish
  3. Confirm
⚠️

Unpublishing doesn't affect existing forks or subscribers. They retain their copies.

Monetization (Coming Soon)

Future features for published workflows:

  • Premium workflows - Charge for access
  • Tips - Accept donations
  • Analytics - See usage statistics

Guidelines

Do

  • ✅ Create workflows that solve real problems
  • ✅ Write clear documentation
  • ✅ Respond to user feedback
  • ✅ Keep workflows updated
  • ✅ Use semantic versioning

Don't

  • ❌ Include sensitive credentials
  • ❌ Copy others' workflows without attribution
  • ❌ Publish incomplete or broken workflows
  • ❌ Use misleading names or descriptions
  • ❌ Spam the marketplace with duplicates

Next Steps

Using with Codex CLIForking & Subscribing