Sitemapper

Travel planning and trip management toolkit. Plan trips, search destinations, manage bookings, track budgets, and journal your travels — all from the command line.

Commands

Run sitemapper <command> [args] to use.

Each data command (plan, search, book, pack-list, budget, convert, weather, route, checklist, journal, compare, remind) works in two modes:

• Without arguments — displays the 20 most recent entries from its log
• With arguments — saves the input with a timestamp to its dedicated log file

Data Storage

All data is stored in ~/.local/share/sitemapper/:

• plan.log, search.log, book.log, pack-list.log, budget.log, convert.log — per-command log files
• weather.log, route.log, checklist.log, journal.log, compare.log, remind.log — additional command logs
• history.log — unified activity history across all commands
• export.json, export.csv, export.txt — generated export files

Set SITEMAPPER_DIR environment variable to override the default data directory.

Requirements

• Bash 4+ with standard coreutils (date, wc, du, tail, grep, sed)
• No external dependencies — pure shell implementation

When to Use

1. Planning a trip — organize itineraries, destinations, and travel dates step by step
2. Tracking travel expenses — log costs, set budgets, and compare spending across trips
3. Managing bookings — keep a record of flights, hotels, and reservations in one place
4. Packing preparation — build and maintain packing lists for different trip types
5. Travel journaling — write timestamped journal entries during or after trips

Examples

# Plan a trip
sitemapper plan "Tokyo 7-day trip: Apr 10-17, budget $2000"

# Search for destinations
sitemapper search "beach destinations southeast asia under $1500"

# Log a booking
sitemapper book "Flight: LAX→NRT Apr 10, ANA NH105, $890 confirmed"

# Create a packing list
sitemapper pack-list "passport, charger, umbrella, medication, camera"

# Track budget
sitemapper budget "Day 1: hotel $120, food $45, transport $15 = $180"

# Check weather for destination
sitemapper weather "Tokyo Apr 10-17: 15-22°C, partly cloudy, light rain expected"

# Write a journal entry
sitemapper journal "Visited Senso-ji temple. Amazing architecture, great street food nearby."

# Export all data as JSON
sitemapper export json

# View recent activity
sitemapper recent

# Show statistics
sitemapper stats

Output

All commands output results to stdout. Log entries are stored with timestamps in pipe-delimited format (YYYY-MM-DD HH:MM|value). Use export to convert all data to JSON, CSV, or plain text.

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com