PICO.WATCH(1)               General Commands Manual                PICO.WATCH(1)

NAME
     pico.watch – send a number to a URL, watch it over time

SYNOPSIS
     curl -X POST https://pico.watch/new
     curl -d value $W/series
     curl $R[/series][.txt|.json|.csv][?window]

DESCRIPTION
     A namespace is two URLs: one to send to, one to read from. POST /new
     returns the pair and nothing else is set up first — there is no account,
     no SDK and nothing to configure. Anything that can make an HTTP request can
     write to it. Every view is a URL, and the same address answers with a
     terminal chart, a summary, JSON or CSV depending on what the client says it
     can read.

START
     # Create a namespace
     curl -X POST https://pico.watch/new
     # …and export the URLs in one step
     eval "$(curl -s -X POST "https://pico.watch/new?env")"
     # …as JSON, for code and agents
     curl -X POST -H "Accept: application/json" https://pico.watch/new

SEND NUMBERS
     # Send a value
     curl -d 21.4 $W/garage.temp
     # Send from a device that can only GET
     curl "$W/garage.temp?v=21.4"
     # Label the units once; it sticks
     curl -d 21.4 "$W/garage.temp?unit=°C"
     # Send a backlog in one request
     printf 'cpu.load 0.8\ncpu.load 0.9\n' | curl --data-binary @- $W
     # Backfill a reading from earlier
     curl -d 21.4 "$W/garage.temp?t=-300"

HEARTBEATS
     # Check in
     curl -X POST $W/backup.nightly
     # From cron, only on success
     0 2 * * * /usr/local/bin/backup.sh && curl -fsS -X POST $W/backup.nightly

READ
     # Everything at a glance
     curl $R
     # One series
     curl $R/garage.temp
     # A different window
     curl "$R/garage.temp?6h"
     # A summary instead of a chart
     curl $R/garage.temp.txt
     # JSON
     curl $R/garage.temp.json
     # CSV
     curl $R/garage.temp.csv

WATCH IT MOVE
     # Follow one series
     curl -N "$R/cpu.load?live"
     # Follow the whole namespace
     curl -N "$R?live"
     # Pick the window it opens on
     curl -N "$R/cpu.load?live&1h"
     # A dashboard on any spare terminal
     watch -n 30 curl -s $R

TERMINAL OPTIONS
     # Match your width
     curl "$R?w=$COLUMNS"
     # No colour
     curl "$R?color=0"
     # 7-bit output for a serial console
     curl "$R?ascii"
     # Light background
     curl "$R?theme=light"
     # Emoji in status markers
     curl "$R?emoji"

MANAGE
     # Delete a series
     curl -X DELETE $W/test.junk
     # Undo that
     curl -X POST $W/test.junk/restore

KEYS
     # Keep the secret out of your shell history
     eval "$(curl -sX POST https://pico.watch/new?env)"

SEE ALSO
     https://pico.watch/docs — every flag and caveat
     https://pico.watch/llms.txt — the same, for models

pico.watch                 https://pico.watch/docs                 PICO.WATCH(1)