zellij-sheets 0.1.1

           _|                              _|      
   _|_|_|  _|_|_|      _|_|      _|_|    _|_|_|_|  
 _|_|      _|    _|  _|_|_|_|  _|_|_|_|    _|      
     _|_|  _|    _|  _|        _|          _|      
 _|_|_|    _|    _|    _|_|_|    _|_|_|      _|_|  

A spreadsheet preview plugin for Zellij with a small native CLI for local smoke testing.

Status

• Plugin target: wasm32-wasip1
• Working formats: CSV, Excel (.xlsx, .xls)
• Pending: Parquet preview

Docs

• API docs: https://docs.rs/zellij-sheets
• Repository: https://github.com/CromboJambo/zellij-sheets

Build

Build the native CLI:

cargo build

Build the Zellij plugin:

cargo build --release --target wasm32-wasip1

Build the optional smoke-test plugin binaries explicitly for the Zellij wasm target:

cargo build --target wasm32-wasip1 --features plugin-smoke --bin plugin-smoke --bin plugin-state-smoke

The plugin artifact is:

target/wasm32-wasip1/release/zellij-sheets.wasm

Install In Zellij

Add the plugin to your Zellij config:

plugins {
    zellij-sheets location="file:/home/youruser/path/to/zellij-sheets/target/wasm32-wasip1/release/zellij-sheets.wasm"
}

Then use it in a layout and pass the file path through plugin configuration:

layout {
    pane {
        plugin location="zellij-sheets" {
            input "/tmp/zellij-sheets-sample.csv"
        }
    }
}

An example alias-based layout is included at layouts/spreadsheet.kdl; it assumes you registered the zellij-sheets plugin in your Zellij config first. Create the sample file before launching the example layout:

printf 'a,b\n1,2\n3,4\n' > /tmp/zellij-sheets-sample.csv

CLI Usage

The native binary renders a plain-text preview and is useful for quick local checks:

cargo run -- --input /absolute/path/to/data.csv

Keys

• Up / Down: move selection
• PageUp / PageDown: move by page
• Home / End: jump to start/end
• q or Ctrl-C: close the plugin

Notes

• The plugin requests hard-drive access and remaps the configured file path through /host/..., matching Zellij's host filesystem model.
• The shared data layer was rebuilt to be wasm-safe, so the plugin and CLI now use the same lightweight grid model.