xl-cli-tools

CLI tools for viewing and editing Excel files
Log | Files | Refs | README | LICENSE

CLAUDE.md (971B)

      1 # xl-cli-tool
      2 
      3 Rust CLI tools for working with Excel (.xlsx/.xls) files, designed for LLM-assisted analysis (Claude Code).
      4 
      5 ## Current tools
      6 - **xlcat** — view/inspect spreadsheets (metadata, schema, stats, data as markdown tables or CSV)
      7 - **xlset** — write cells preserving formatting/formulas/structure
      8 - **xlfilter** — query/filter rows and columns from spreadsheets
      9 - **xldiff** — compare two sheets, report added/removed/modified rows
     10 
     11 ## Architecture
     12 - Shared library in `src/lib.rs` (reader, formatter, metadata, cell, writer, filter, diff modules)
     13 - Binary entry points in `src/bin/`
     14 - Dependencies: calamine (read), umya-spreadsheet (write), polars (data), clap (CLI), serde_json (JSON output)
     15 
     16 ## Conventions
     17 - Exit codes: 0 = success, 1 = runtime error, 2 = invalid arguments
     18   - Exception: xldiff uses diff(1) convention: 0 = no differences, 1 = differences found, 2 = error
     19 - Output: markdown tables by default, CSV with `--csv`
     20 - Rust edition 2024