cell

A terminal spreadsheet editor with Vim keybindings, written in Rust.

Install

From crates.io:

cargo install cell-sheet-tui

Pre-built binaries for Linux, macOS, and Windows are available on the GitHub Releases page.

Build from source

git clone https://github.com/garritfra/cell.git
cd cell
cargo build --release
# Binary at target/release/cell

Usage

cell                          # empty sheet
cell data.csv                 # open CSV
cell data.tsv                 # open TSV
cell sheet.cell               # open native format
cell data.psv --delimiter '|' # open with a custom field delimiter
cat data.csv | cell           # read from stdin (pipe input)

To explore an example sheet with formulas, ranges, and IF logic:

cell examples/demo.cell

The CSV/TSV delimiter is auto-detected from file content; pass --delimiter to override. The native .cell format is auto-detected via its # cell v magic header.

Headless mode

For shell pipelines, Makefiles, and CI, cell can read from and write to a file without launching the TUI:

cell sales.cell --read A1                 # print one cell's computed value
cell sales.cell --read B1:B10             # print a range as TSV
cell sales.cell --eval '=SUM(B1:B10)'     # evaluate a formula (no save)
cell sales.cell --write A1 42             # set a cell, recalc, save in place
cell sales.cell --write A1 42 --write B1 7 # batch multiple writes into one save
cell sales.cell --write Total '=SUM(B:B)' --read Total  # write a formula, then print it
cat data.csv | cell --read A1             # read from stdin
cell data.psv --delimiter '|' --read A1   # custom delimiter

• Cell references are 1-indexed and Excel-style (A1, AA10, A1:B3).
• The = prefix on --eval is optional.
• Writes whose value starts with = are stored as formulas; others are auto-typed (number vs text).
• Operations apply in a fixed order per invocation: writes → save → reads → evals.
• Errors print to stderr; the process exits non-zero on bad refs, parse errors, or missing files.
• Stdin input supports CSV, TSV, and the native .cell format. The delimiter is auto-detected; pass --delimiter to override (CSV/TSV only). --write requires a file argument when reading from stdin.

Keybindings

If you know Vim, you know cell.

All motions and operators accept a [count] prefix (5j, 10G, 3dd, 4yy, 2w). Counts also work between an operator and its motion (d3j, y2k); outer and inner counts multiply (5d2j clears 10 rows). The in-progress count and operator render in the status line as you type.

Normal Mode

Motion

Marks

Editing

Selection & search

Insert Mode

Type to edit the cell. ESC or Enter confirms. Arrow keys, Home, End, Backspace, and Delete work as expected within the cell.

Visual Mode

Extend the selection with hjkl (or [count]j etc.), then:

Commands

In the : prompt, ↑ / ↓ cycle through previously executed commands.

Mouse support

Mouse support is off by default so the terminal's native text selection keeps working. Enable it at runtime with :set mouse on, disable it with :set mouse off, or flip the current state with :set mouse toggle.

When enabled:

• Left-click on a cell moves the cursor.
• Click + drag inside the grid selects a Visual range.
• Click + drag on a column header selects whole columns.
• Click + drag on a row header selects whole rows.
• Scroll wheel scrolls the viewport (cursor stays put). Horizontal scroll works when the terminal emits ScrollLeft / ScrollRight (commonly bound to Shift + wheel).
• Double-click a cell to enter Insert mode on it.
• Drag past the visible edge auto-scrolls the viewport.

To copy a cell value out to your system clipboard while mouse mode is on, hold your terminal's bypass modifier when clicking and dragging:

Formulas

Formulas start with = and support Excel-compatible syntax:

=A1+B1
=SUM(A1:A10)
=AVERAGE(B1:B5)
=IF(A1>100, "high", "low")

Supported Functions (v1)

SUM, AVERAGE, COUNT, MIN, MAX, IF

Formula compliance with the ODF (OpenDocument Formula) spec is tracked and will expand over time.

File Formats

• CSV/TSV -- Opens and saves standard comma/tab-separated files. Formulas are flattened to their computed values on CSV export.
• **.cell** -- Native format that preserves formulas. Plain text, human-readable, inspired by sc-im.

When saving a CSV that contains formulas, cell warns you and suggests saving as .cell instead. Use :w! to force a CSV save.

Comparison with sc-im

sc-im is a battle-tested terminal spreadsheet built on the classic sc (Spreadsheet Calculator, 1981). It inspired cell's native .cell format. Here's how the two tools compare:

Choose cell if…

• You want editing that works exactly like Vim (i to insert, ESC to return, / to search)
• You prefer Excel-compatible formula syntax (=SUM, =IF, =AVERAGE)
• You need a working binary on Windows without extra setup
• You value a modern, memory-safe codebase with minimal dependencies

Choose sc-im if…

• You need XLSX, ODS, or Markdown support right now
• You need Lua scripting or GNUPlot charting right now
• You need cell-level formatting (colors, bold, italic) right now
• You want a highly configurable, feature-rich tool with decades of history behind it

Architecture

cell/
  crates/
    cell-sheet-core/    # Data model, formula engine, file I/O (no TUI dependency)
    cell-sheet-tui/     # Ratatui rendering, Vim modes, event loop

The core library is independent of the terminal UI and can be tested without a terminal.

Releasing

Releases are automated with release-plz from the release workflow:

• Pushes to main open or update a release PR with the next version and changelog updates.
• Merging the release PR publishes cell-sheet-core and cell-sheet-tui to crates.io via trusted publishing, creates the vX.Y.Z tag, and creates a draft GitHub Release.
• The vX.Y.Z tag then builds binaries for Linux (x86_64, aarch64), macOS (x86_64, aarch64), and Windows (x86_64), uploads archives and SHA256 checksums, and publishes the GitHub Release.

See RELEASE.md for maintainer instructions and failure handling.

Contributing

Contributions are welcome. See CONTRIBUTING.md for the development setup, project conventions, and pull request workflow.

License

MIT