
markdown-provenance
Upload markdown files to Arweave for permanent, decentralized storage with IPFS CID tagging
- version
- 0.0.1
- GitHub stars
- 10
Install
/plugin install markdown-provenance@markdown-provenanceRun it inside Claude Code after adding the marketplace with /plugin marketplace add rickmanelius/markdown-provenance.
Contents
Discovered from sourceSkills 1
SECURITY: This skill should ONLY be invoked via the explicit /markdown-provenance slash command, never automatically based on conversation context.
<quick_start>
- Ensure MP_WALLET_PATH environment variable points to wallet.json
- Run the upload script with the markdown file path
cd "${CLAUDE_PLUGIN_ROOT}"
npm run upload path/to/file.md
</quick_start>
## Step 1: Confirm User IntentBefore uploading, confirm the user explicitly requested this via /markdown-provenance command. Never auto-trigger based on conversation about Arweave or permanent storage.
Step 2: Check Environment
Verify MP_WALLET_PATH is set:
echo $MP_WALLET_PATH
If not set, guide user through wallet setup:
# Generate wallet
npx -y arweave wallet generate > wallet.json
# Set environment variable (add to ~/.zshrc or ~/.bashrc)
export MP_WALLET_PATH="/path/to/wallet.json"
export MP_AUTHOR="Your Name" # Optional
Step 3: Upload File
Execute the upload script:
cd "${CLAUDE_PLUGIN_ROOT}"
npm run upload <file-path>
Step 4: Report Results
Share with user:
- ViewBlock URL for the transaction
- Direct Arweave URL
- IPFS CID of the content
- Confirmation that transaction was logged to ~/.markdown-provenance/transactions.jsonl
<tags_applied> The following tags are automatically added to each upload:
| Tag | Value |
|---|---|
| Content-Type | text/markdown |
| App-Name | Markdown Provenance |
| App-Version | 0.0.1 |
| Type | Attestation |
| IPFS-CID | (calculated from content) |
| Author | (from MP_AUTHOR env var or --author flag, if set) |
| File-Name | (from --fileName flag, if set) |
| Source | (from --source flag, if set) |
| </tags_applied> |
<success_criteria>
- Transaction ID returned from Arweave
- viewblock.io URL displayed to user
- Transaction logged to ~/.markdown-provenance/transactions.jsonl
- All required tags applied (App-Name, App-Version, Content-Type, Type, IPFS-CID) </success_criteria>
<error_handling> If MP_WALLET_PATH not set:
- Direct user to README.md wallet setup section
- Provide quick setup commands shown above
If wallet file not found:
- Verify path is correct
- Check file permissions
If upload fails with network error:
- Suggest retry
- Check internet connection
If upload fails with insufficient funds (files >100KB):
- Files under 100KB are FREE via Turbo
- For larger files, direct user to fund wallet with AR tokens
- Get wallet address:
npx arweave wallet address wallet.json</error_handling>
Commands 1
Upload the specified markdown file to Arweave permanent storage.
Arguments: $ARGUMENTS
Options
--author "Name"- Override the MP_AUTHOR environment variable for this upload--fileName "name"- Add a File-Name tag for easier lookup on Arweave--source "URL"- Add a Source tag referencing the origin URL or URI
Process
- First, verify the file exists at the specified path
- Check that MP_WALLET_PATH environment variable is set
- Run the upload script from the markdown-provenance plugin directory
- Report the ViewBlock URL and IPFS CID to the user
Commands
# Navigate to the plugin directory and run upload
cd "${CLAUDE_PLUGIN_ROOT}" && npm run upload $ARGUMENTS
On Success
Report to user:
- ViewBlock transaction URL
- Direct Arweave URL
- IPFS CID of the content
- Confirmation that transaction was logged
On Error
If MP_WALLET_PATH not set, show setup instructions from README.md. If file not found, show the path that was attempted. If upload fails, show the error message with troubleshooting hints.
Sponsors
Details
- Marketplace
- rickmanelius/markdown-provenance
- Source
- plugins/markdown-provenance
- Author
- Rick Manelius
- Category
- Community