Manifest Spec
Put a YAML file in your repo. Your listing stays in sync.
What it is
A walnut.manifest.yaml file in the root of your repository tells walnut.world how to display your listing. When you submit a repo URL with a manifest, the platform reads it and keeps your listing automatically in sync with your repo.
Minimum viable manifest
Four lines. That's all you need.
walnut.manifest.yaml
name: "My Thing" description: "It does the thing" tags: [tool, ai] author: "me"
Full manifest
Every field the platform understands.
walnut.manifest.yaml
# Required name: "My Thing" description: "A longer description of what it does" tags: [tool, ai, productivity] author: "username" # Category (default: tool) # Options: tool, skill, plugin, mcp, capsule, site, game, data category: "tool" # URLs url: "https://my-thing.com" repo: "https://github.com/me/my-thing" # Pricing (omit for free) price: 29 # in USD cents? no — whole dollars currency: "USD" # default payment: stripe: "https://buy.stripe.com/xxx" gumroad: "https://me.gumroad.com/l/thing" solana: "solana:ADDRESS?amount=29" # Metadata version: "1.2.0" license: "MIT" # Fulfillment (shown to buyer after purchase) fulfillment: "Download at https://releases.my-thing.com/latest"
Required fields
| Field | Type | Description |
|---|---|---|
| name | string | Display name of your listing |
| description | string | What it does, why someone would want it |
| tags | string[] | Array of lowercase tags for discoverability |
| author | string | Your walnut.world username |
Optional fields
| Field | Type | Default | Description |
|---|---|---|---|
| category | string | "tool" | One of: tool, skill, plugin, mcp, capsule, site, game, data |
| url | string | — | Homepage or landing page URL |
| repo | string | — | Source code repository URL |
| price | number | 0 (free) | Price in whole dollars |
| payment | object | — | Key-value map of payment provider to URL |
| version | string | — | Semver string displayed on listing |
| license | string | — | SPDX license identifier (MIT, Apache-2.0, etc.) |
| fulfillment | string | — | Text shown to buyer after purchase |
What the platform auto-pulls
When you submit a repo URL, walnut.world reads the manifest and also pulls:
- README — displayed on the listing detail page
- LICENSE — auto-detected and shown as a badge
- Stars / forks — displayed as social proof
- Last commit date — shown to indicate activity