Publishing Tools

Share your tools with the community by publishing to the SmartTools Registry.

Before Publishing

Make sure your tool has:

• A descriptive name and description
• A proper version (semver format: 1.0.0)
• A README.md file with usage examples
• Tested and working functionality

Create an Account

Register at the registry to get your publisher namespace.

Get an API Token

1. Go to your Dashboard → Tokens
2. Click "Create New Token"
3. Copy the token (shown only once!)

Publish Your Tool

# Navigate to your tool directory
cd ~/.smarttools/my-tool/

# First time: enter your token when prompted
smarttools registry publish

# Dry run to validate without publishing
smarttools registry publish --dry-run

Versioning

Published versions are immutable. To update a tool:

1. Make your changes
2. Bump the version in config.yaml
3. Run smarttools registry publish

Best Practices

• Clear names - Use descriptive, lowercase names with hyphens
• Good descriptions - Explain what the tool does in one sentence
• Document arguments - Describe each flag in the help text
• Include examples - Show real usage in your README
• Choose the right category - Help users discover your tool