lnget

Download files with automatic L402 Lightning micropayments. When a server returns HTTP 402 Payment Required with an L402 challenge, lnget automatically pays the Lightning invoice and retries the request.

Quick Reference

# JSON metadata + inline response body
lnget --json --print-body https://api.example.com/data.json

# Pipe raw response body to stdout
lnget -q https://api.example.com/data.json | jq .
lnget -o - https://api.example.com/data.json

# Preview payment without executing
lnget --dry-run https://api.example.com/paid-endpoint

# Agent-first JSON input
lnget --json --params '{"url": "https://api.example.com/data", "max_cost": 500}'

# Introspect CLI schema
lnget schema --all

# Manage tokens
lnget tokens list --json --fields domain,amount_sat

# Check Lightning backend
lnget ln status --json

Key Rules

1. Always use

   --json

   for machine-readable output
2. Use

   --print-body

   with

   --json

   to get response content inline
3. Use

   --dry-run

   before making payments
4. Use

   -q

   or

   -o -

   when you only want the raw response body
5. Use

   --fields

   to limit output to needed fields
6. Use

   --force

   on destructive commands (tokens clear)
7. Check

   lnget schema <command>

   for parameter details

Full skill documentation

See

skills/lnget/SKILL.md

for comprehensive usage guide.