CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Development Commands

Build project: cargo build
Build release: cargo build --release
Run locally: cargo run -- <subcommand> <args> (e.g., cargo run -- add "test item")
Run tests: cargo test
Check code: cargo check
Format code: cargo fmt
Lint code: cargo clippy
Install from source: cargo build --release && cp target/release/ldr ~/.local/bin/

LDR is a Rust CLI productivity application implementing the "append-and-review" note system. The architecture follows a clean separation of concerns:

main.rs: Entry point with CLI definition using clap. Handles XDG-compliant data directory setup (~/.local/share/ldr/) for note.txt and archive.txt files
commands.rs: Command implementations with terminal I/O, file operations, and colored output using termion
content.rs: Pure functions for content manipulation without side effects - handles all core logic for text processing
input.rs: Raw keyboard input handling for interactive review mode, processes ANSI escape sequences for arrow keys

Separation of pure functions: Core logic in content.rs is stateless and easily testable
XDG compliance: Uses xdg crate for proper data directory handling
Terminal UI: Interactive review mode with keyboard navigation and colored output
File-based storage: Simple text files for persistence (note.txt for active items, archive.txt for completed)

The scan command provides a sophisticated interactive interface: