• Update README with current API URL (http://localhost:23373) and BEEPER_TOKEN guidance\n- Ignore docs/plans and clean plan artifacts

What's New

New Commands

• beeper info - Display CLI and environment information for diagnostics
• beeper info --test-permissions - Test API token permissions

New Flags

• --quiet / -q - Suppress non-essential output (hints, update notifications)
• --json-errors - Output errors as JSON to stderr for programmatic parsing

Improvements

• Structured error messages with actionable hints
• Auto-update notifications with 24-hour cache
• Help footer with documentation links on all commands
• Enhanced config help with detailed field descriptions
• Standardized exit codes: 0=success, 1=user error, 2=system error

For LLMs and Automated Agents

• JSON error output format with category, code, operation, and hint fields
• Comprehensive troubleshooting section in README
• Permission testing via beeper info --test-permissions
• Quiet mode for cleaner automation

Full Changelog

v0.3.0...v0.4.0

What's New

Features

• Self-upgrade command - Run beeper upgrade to update to the latest version
• Version command - Run beeper version to see build info
• ASCII art banner - Beautiful startup banner when running without arguments
• Demo video - Animated GIF showcasing CLI features with Beeper branding

Fixes

• Fixed search response parsing for wrapped {items: [...]} format
• Fixed search default limit (100 → 20 to match API maximum)

Demo

Full Changelog: v0.1.0...v0.2.0

Initial release of Beeper CLI

Features:

• Full read/write API support
• Auto-discover Beeper Desktop API
• LLM-friendly output formats (JSON, text, markdown)
• Cross-platform binaries (macOS, Linux, Windows)
• Chat management (list, get)
• Message operations (list, send, search)
• Configuration management

Install:
Download the appropriate binary for your platform and add to PATH.

Example usage:

beeper discover
beeper chats list
beeper send --chat-id CHAT_ID --message "Hello!"