Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

CLI Metadata

Manage metadata for pinned content.

metadata command

pinner metadata <cid>

Set Metadata

# Set key-value pairs
pinner metadata bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq --set category=backup --set environment=prod
 
# From stdin (key=value per line)
echo -e "category=backup\nenvironment=prod" | pinner metadata bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq

Clear Metadata

# Clear all metadata
pinner metadata bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq --clear

Preview Mode

# Preview without making changes
pinner metadata bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq --set category=backup --dry-run

Options

OptionDescription
--setSet metadata as key=value (repeatable)
--clearClear all metadata
--dry-runPreview operation without making changes

Examples

# Set multiple metadata fields
pinner metadata bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq --set author=alice --set version=1.0 --set date=2024-01-15
 
# Clear and set new metadata
pinner metadata bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq --clear --set newkey=newvalue
 
# Preview changes
pinner metadata bafybeiemxf5abjwjbikoz4mc3a3dla6ual3jsgpdr4cjr3oz3evfyavhwq --set category=backup --dry-run