zellij-sheets 0.1.0

Terminal-based spreadsheet viewer powered by Zellij
Documentation
           _|                              _|      
   _|_|_|  _|_|_|      _|_|      _|_|    _|_|_|_|  
 _|_|      _|    _|  _|_|_|_|  _|_|_|_|    _|      
     _|_|  _|    _|  _|        _|          _|      
 _|_|_|    _|    _|    _|_|_|    _|_|_|      _|_|  

Crates.io Docs.rs License: AGPL-3.0-or-later Rust

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

Build

Build the native CLI:

cargo build

Build the Zellij plugin:

cargo build --release --target wasm32-wasip1

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 "/absolute/path/to/data.csv"
        }
    }
}

An example layout is included at layouts/spreadsheet.kdl.

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.