Terminal

waltspence.com — terminal guide
=====================================

Everything on this site works without a browser. Append .json, .txt or .md to a
permalink, or ask the API. Examples:

  curl https://waltspence.com/now.txt                     # what Walt is doing now
  curl https://waltspence.com/changes.txt                 # what changed recently
  curl https://waltspence.com/notes.txt                   # index of Notes
  curl https://waltspence.com/notes/SLUG.md               # a Note as Markdown with front matter
  curl https://waltspence.com/notes/SLUG.txt              # a Note as plain text
  curl https://waltspence.com/thoughts.txt                # the stream
  curl https://waltspence.com/thoughts.txt?source=native  # only native Thoughts
  curl https://waltspence.com/projects.txt                # the bench
  curl https://waltspence.com/podcast/SLUG.txt            # episode notes + transcript
  curl "https://waltspence.com/search.txt?q=dns"          # search

JSON API (read-only, no auth, CORS open):

  curl https://waltspence.com/api/v1                      # capabilities index
  curl https://waltspence.com/api/v1/notes?page=2
  curl https://waltspence.com/api/v1/thoughts?source=native
  curl https://waltspence.com/api/v1/projects?status=active
  curl "https://waltspence.com/api/v1/search?q=tailscale&kind=note"

Content negotiation also works:

  curl -H 'Accept: application/json' https://waltspence.com/notes/SLUG
  curl -H 'Accept: text/plain' https://waltspence.com/projects/SLUG

Feeds:

  https://waltspence.com/feed.xml            everything (Atom)      https://waltspence.com/feed.json
  https://waltspence.com/notes/feed.xml      Notes                  https://waltspence.com/notes/feed.json
  https://waltspence.com/thoughts/feed.xml   Thoughts               https://waltspence.com/thoughts/feed.json
  https://waltspence.com/projects/feed.xml   project changelogs
  https://waltspence.com/podcast/feed.xml    podcast (RSS 2.0)
  https://waltspence.com/topics/SLUG/feed.xml

Machines:

  https://waltspence.com/llms.txt   https://waltspence.com/sitemap.xml   https://waltspence.com/robots.txt   https://waltspence.com/humans.txt
  POST https://waltspence.com/webmention  (source=…&target=…)

Handy:

  watch -n 300 'curl -s https://waltspence.com/thoughts.txt | head -40'
  curl -s https://waltspence.com/api/v1/notes | jq -r '.notes[] | "\(.published_at[:10])  \(.title)"'