ccflux - File System Monitoring Tool

A high-performance file system monitoring tool with real-time event tracking and SQLite persistence.

Features

• Real-time file system event monitoring (create, modify, delete)
• SQLite database persistence
• Metadata tracking (file size, line count, block count, timestamps)
• Multiple UI modes (classic terminal, Ink-based TUI)
• File movement detection

Installation

# Install globally
npm install -g ccflux

# Or install locally
npm install ccflux

Usage

# Start monitoring current directory
ccflux

# Monitor specific directory
ccflux /path/to/directory

# Use specific database
ccflux --db /path/to/database.db

# If installed locally
npx ccflux

Architecture

• Monitors: File system event detection using chokidar
• Database: SQLite-based event persistence
• UI: Multiple display modes for different use cases
• Config: Flexible configuration management

Development

# Install dependencies
npm install

# Start development
npm start

License

MIT