Publishing Agents

Learn how to package, test, and publish your agent to the METAOS marketplace.

⚠️
Coming Soon
Agent publishing is under active development. This guide describes the planned workflow. Follow along with current CLI implementation in the quickstart guide.

Publishing Workflow (Planned)

1

Build Your Agent

Create your agent using the CLI and test it locally:

metaos init metaos agent run myagent --intent test "Hello"
2

Create Manifest

Define your agent's metadata and required capabilities:

{ "id": "com.example.myagent", "name": "My Agent", "version": "1.0.0", "description": "Does amazing things", "capabilities": ["storage.write", "web.search"] }
3

Run Tests

Validate your agent passes all requirements:

metaos test # Will check: # - Manifest validity # - Required capabilities # - Response formats # - Error handling
4

Build Package

Create a signed, distributable package:

metaos build # Creates: myagent-1.0.0.meta # - Minified code # - Signed manifest # - Asset bundle
5

Publish to Registry

Submit your agent for review:

metaos publish # Uploads to METAOS registry # Triggers automated security scan # Queues for human review
6

Review Process

METAOS reviews your agent for:

  • Privacy compliance (no data exfiltration)
  • Permission correctness (declared capabilities match usage)
  • Content policy (no harmful functionality)
  • Code quality (error handling, edge cases)
7

Go Live

Once approved, your agent appears in the marketplace and users can install it!

Publishing Requirements

✅ Valid Manifest

Must include id, name, version, description, and capabilities array

✅ Capability Declarations

All tools used in code must be declared in manifest capabilities

✅ Error Handling

Must gracefully handle API failures and return user-friendly error messages

✅ Privacy Policy

If your agent processes user data, you must provide a privacy policy URL

✅ Tests

Include test cases demonstrating key functionality

Versioning & Updates

Use semantic versioning (semver) for your agent versions:

1.0.0 → 1.0.1 - Bug fixes (auto-update)
1.0.0 → 1.1.0 - New features (user prompted)
1.0.0 → 2.0.0 - Breaking changes (requires review)

Monetization (Future)

Planned pricing models for published agents:

Free

Open source or ad-supported agents

One-time

Single purchase (e.g., $4.99)

Subscription

Recurring monthly/yearly fee

Current Status

🚧 In Development

The publishing workflow is being built. Current priorities:

  1. Complete Tool Gateway implementation (more tools beyond storage.write)
  2. Build Agent Registry backend (publish, list, install endpoints)
  3. Create CLI publish command
  4. Implement review system
  5. Launch marketplace frontend

Get Started Today

🚀 Build & Test Locally

Install the CLI and start building your agent today

💡 View Examples

See complete agent implementations

📢 Follow Development

Watch the GitHub repo for updates on publishing features