mercury

x51@cyberspace:~$ man mercury

MERCURY(1)@kung-fu Commands ManualMERCURY(1)

name

mercury — a CLI tool for organizing and managing your digital life

synopsis

mercury <tool> [command] [options] [arguments]
      mercury list

description

mercury collects the small, daily utilities of a digital life under one binary: reading lists and RSS feeds, bookmarks and calendars, weather and sky charts, project tracking and system stats. Each tool is a subcommand with its own options; mercury list prints the full registry. Everything runs in the terminal, with an optional web dashboard for the things that read better in a browser.

tools // the digital life

tool	description
`book`	track reading with Open Library integration and collections
`feed`	subscribe to and read RSS/Atom feeds with article tracking
`bookmark`	save, organize, and manage bookmarks with tags
`calendar`	manage iCal subscriptions and event calendars
`trip`	track travel and calculate carbon footprint
`music`	music listening statistics from ListenBrainz
`now`	manage your /now page data
`dict`	look up words and definitions
`finger`	look up people by username, finger(1)-style

tools // sky & cosmos

tool	description
`weather`	forecasts from the National Weather Service
`solar`	visualize the 24-hour light cycle and sunrise/sunset
`lunar`	lunar phase and moonrise/moonset times
`space`	ISS location and space information
`pagan`	pagan calendar dates

tools // development

tool	description
`p`	manage projects with status tracking and filtering
`gh`	GitHub issues and pull requests across repositories
`sql`	SELECT-only SQL queries against SQL Server, safely
`api`	REST API testing with config files and reporting
`wcag`	WCAG accessibility compliance scanning (A / AA / AAA)
`status`	monitor URL availability and response times
`dump`	PostgreSQL backups in sql, custom, or tar formats
`system`	real-time CPU, RAM, disk, GPU, and temperature stats

tools // diversions

tool	description
`engage`	USS Enterprise ASCII art. Make it so
`flip` / `roll`	coin flips and dice rolls
`ufo`	search and display UFO sighting reports
`neofetch`	system info with ASCII art

examples

An at-a-glance system overview:

$ mercury system
      
      ┌─────────────────────────────────────────────┐
      │             System Overview                 │
      └─────────────────────────────────────────────┘
      
        CPU    ████████░░░░░░░░░░░░░  40%  3.5GHz
        RAM    ██████░░░░░░░░░░░░░░░░  30%  8.2GB/32GB
        Swap   ░░░░░░░░░░░░░░░░░░░░░░   0%  0B/2GB
        Disk   ███████░░░░░░░░░░░░░░░  35%  175GB/500GB
      
        Load: 1.25    Uptime: 3d 4h 12m

Weather for a ZIP code (or your configured default):

$ mercury weather 90210
      
      ✔ Weather data loaded
      
      Weather Forecast for Beverly Hills, CA
      ──────────────────────────────────────────────
      Current: Today
      🌡️  Temperature: 72°F
      💨 Wind: 5 mph NW
      ☁️  Conditions: Sunny and clear
      
      Data provided by the National Weather Service (weather.gov)

Active projects, filtered by status:

$ mercury p list -s active
      
      ● Frontend Platform - Main user interface
        Team: frontend | Status: active
      ● API Gateway - Backend REST API
        Team: backend | Status: active
      ● Database Migration - v2.0 schema upgrade
        Team: devops | Status: active

A compressed PostgreSQL backup:

$ mercury dump mydb --compress
      
      ✔ Backup completed successfully
      Details:
        Database: mydb
        File: ./backups/mydb_2024-02-13T15-45-30-123Z.sql.gz
        Size: 245M
        Format: sql (compressed)

dashboard

The one piece of mercury that isn’t a terminal: mercury dashboard (aliases dash, web) starts a local web server with pages for books, feeds, bookmarks, and trips.

mercury dashboard --port 3000 --open

configuration

Settings live under ~/.mercury/ and are managed with the config tool (aliases cfg, settings) — show, set, unset, and an interactive setup wizard:

mercury config set weather.zipCode 22903

mercury config show weather

files

file	description
`~/.mercury/config.json`	global configuration, managed by `mercury config`
`~/.mercury/*-config.json`	per-tool configuration (github, weather, status, dashboard)
`.env`	environment overrides sourced at startup