herenowcli

CLI tool for here.now - publish files to the web instantly.

██╗  ██╗███████╗██████╗ ███████╗   ███╗   ██╗ ██████╗ ██╗    ██╗
██║  ██║██╔════╝██╔══██╗██╔════╝   ████╗  ██║██╔═══██╗██║    ██║
███████║█████╗  ██████╔╝█████╗     ██╔██╗ ██║██║   ██║██║ █╗ ██║
██╔══██║██╔══╝  ██╔══██╗██╔══╝     ██║╚██╗██║██║   ██║██║███╗██║
██║  ██║███████╗██║  ██║███████╗██╗██║ ╚████║╚██████╔╝╚███╔███╔╝
╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚══════╝╚═╝╚═╝  ╚═══╝ ╚═════╝  ╚══╝╚══╝ 
────────────────────────────────────────────────────────────────
        Publish files to the web instantly • here.now
────────────────────────────────────────────────────────────────

Installation

npx herenowcli

Or install globally:

npm install -g herenowcli
herenow

Usage

Interactive Mode

Just run herenow without arguments for an interactive menu:

herenow

This will show:

• Login status (logged in = permanent, not logged in = 24 hour expiry)
• Menu with all available actions
• Press ESC to go back, Ctrl+C to exit

Commands

| Command | Description | |---------|-------------| | herenow | Interactive menu mode | | herenow login [email] | Login with email (sends magic link) | | herenow logout | Logout and remove API key | | herenow whoami | Show authentication status | | herenow publish [path] | Publish file or directory | | herenow list / ls | List your publishes | | herenow delete <slug> | Delete a publish | | herenow claim <slug> | Claim anonymous publish | | herenow update <slug> [path] | Update existing publish | | herenow metadata <slug> | Update publish metadata | | herenow refresh <slug> | Refresh upload URLs |

Publish Options

herenow publish [path] [options]

Options:
  -t, --title <title>       Title for auto-viewer page
  -d, --description <desc>  Description for auto-viewer page
  --ttl <seconds>           Time to live in seconds (authenticated only)
  --open                    Open the published URL in browser

Examples

# Interactive mode
herenow

# Publish current directory
herenow publish .

# Publish specific file
herenow publish ./dist/index.html

# Publish with title and description
herenow publish ./site --title "My Site" --description "My awesome site"

# Login for permanent publishes
herenow login [email protected]

# List all your publishes
herenow list

# Claim an anonymous publish
herenow claim my-site-abc1 --token abc123...

Authentication

• Not logged in: Publishes are anonymous and expire in 24 hours
• Logged in: Publishes are permanent (or custom TTL)

To login:

herenow login [email protected]

This sends a magic link to your email. Click the link, get your API key from the dashboard, and paste it in the CLI.

Features

• Interactive Menu - Easy to use with keyboard navigation
• Anonymous Publishing - No account needed, publishes last 24h
• Permanent Publishing - Login for permanent sites
• Multiple Files - Publish entire directories
• Auto Viewer - Automatic viewer for images, PDFs, videos
• Claim Anonymous - Claim your anonymous publish to make it permanent

Development

# Install dependencies
npm install

# Build
npm run build

# Dev mode
npm run dev

License

MIT