BlueMind CLI Tools

Command-line tools for managing BlueMind email filters, notifications, and more.

Features

• Filters management: collect, validate, optimize and restore email filters
• Multi-profile support: manage multiple BlueMind instances
• XDG Base Directory compliance: respects Linux standards
• Secure configuration: encrypted credentials with proper permissions
• Comprehensive logging: separate debug/info and error logs

Installation

npm install
npm link

Configuration

Configuration files are stored in ~/.config/bm-cli-tools/profiles/.

Create a profile (or migrate from existing .env.local):

# Create default profile
bm-cli-tools config create

# Create named profile
bm-cli-tools config create --profile work

Usage

Filters

# Collect filters from BlueMind
bm-cli-tools filters collect

# Validate filters (check broken filters)
bm-cli-tools filters validate

# Optimize filters (detect redundancies)
bm-cli-tools filters optimize

# Restore from backup
bm-cli-tools filters restore

# Apply filters to INBOX messages
bm-cli-tools filters apply                    # Interactive mode, 50 messages per batch
bm-cli-tools filters apply --count 100        # Process 100 messages per batch
bm-cli-tools filters apply --dry-run          # Simulate without moving messages
bm-cli-tools filters apply --auto             # Auto-process all batches
bm-cli-tools filters apply --skip 50          # Skip 50 recent messages

Global Options

--profile <name>        Use specific profile (default: "default")
--config-dir <path>     Override config directory
--cache-dir <path>      Override cache directory
--backups-dir <path>    Override backups directory
--log-level <level>     Set log level (error|warn|info|debug)
--no-color              Disable colored output

Directory Structure

~/.config/bm-cli-tools/
├── profiles/
│   ├── default.json
│   └── work.json
└── backups/
    └── filters-backup-*.json

~/.cache/bm-cli-tools/
└── filter-collection.json

/tmp/
├── bm-cli-tools-<timestamp>.log
└── bm-cli-tools-<timestamp>-error.log

Development

# Run from source
node bin/bm-cli-tools.js filters collect --log-level debug

# Link for global usage
npm link

License

ISC