OmaSheets

A spreadsheet for Omarchy, with agent changes you can review.

OmaSheets gives you a local spreadsheet window and a way to let your configured agent inspect workbooks, explain formulas and propose changes. You review the evidence and approve the result. The native document stack adds a Qt grid, a Rust formula engine and replayable edit history, with branches for proposed work and checks before a human-approved merge.

Development preview: native .omasheets documents support keyboard editing, range copy/paste with relative formulas, undo/redo, bounded XLSX import, and CSV, XLSX and Parquet export. Existing Excel and OpenDocument workbooks use the separate LibreOfficeKit compatibility window. Native import/export reports what cannot be preserved; it does not promise full Excel fidelity.

Open OmaSheets: after installing a matching current build, choose OmaSheets from the app launcher or run omasheets. Create a workbook with Ctrl+N, open one with Ctrl+O, and press F1 for the keyboard guide. Native edits save when you finish each cell; the File menu offers import and export. Install the Arch package and choose Try an example for a guided first workbook. Published development builds need no GitHub login or local compiler; the published v0.0.2 release remains the older compatibility baseline.

The CI workflow checks replay, rejected edits, clipboard round-trips and compiler-free Arch installation. Real Omarchy acceptance, refreshed corpus evidence and release signing remain v0.1.0 release gates.

v0.0.2 scope

• Open .xls, .xlsx, .xlsm, and .ods in LibreOffice Calc.
• Inspect workbook structure, values, formulas, named ranges, deduplicated cell styles, and formula errors.
• Audit every bounded used range for table structure, missing or duplicate headers, duplicate rows, sparse columns, numeric outliers, formula errors, existing charts and pivots, and management-summary opportunities.
• Trace formula precedents and dependents within a bounded request.
• Stage cell-value and formula changes against an immutable source hash.
• Stage bounded bulk values, bulk formulas, and typed cell formatting.
• Insert and delete bounded rows or columns, fill formulas with Calc's reference-aware engine, and sort bounded ranges.
• Create or update typed column, bar, line, pie and scatter charts; create, update and refresh typed pivot tables with bounded sources.
• Require every agent proposal to state its goal, summary, assumptions, evidence and purpose-grouped operations.
• Revise a verified proposal by superseding it; never silently mutate a plan already presented for review.
• Recalculate, reopen, render, and compare staged output before approval.
• Require a local, explicit approval before publishing workbook bytes.
• Preserve legacy .xls originals and convert only to a new .xlsx file.
• Expose read and planning operations to agents over MCP; never expose commit.

OmaSheets does not claim perfect Microsoft Excel compatibility. In particular, macro-enabled .xlsm workbooks are read-only in v0.0.2 and legacy conversion always requires manual review.

The product and safety contracts are in docs/. The in-place native-core decision and its measured milestone gates are in ADR-0003 and the OmaSheets roadmap. The v0.0.2 release remains the compatibility and agent-safety baseline. The native document stack now exists on the development branch, but it is not a released compatibility claim. The evidence required before the first public native alpha is listed separately in the v0.1.0 native release gate. The native service can also convert a bounded .xlsx source into a new replayable .omasheets document. It never replaces an output file and returns a loss manifest; this is an alpha import path, not a full-fidelity Excel claim. The same authenticated service binary ships inside the verified native bundle; the compiler-free Arch acceptance runs its complete local review workflow after installation.

Install on Omarchy

1. Open downloads and choose OmaSheets-Setup-linux-x86_64.tar.gz from the newest development build.
2. Extract it and open omasheets-setup. Choose Install / update OmaSheets; authorise system package setup if asked.
3. Choose Open OmaSheets, then New workbook, Open workbook, or Try an example.

The example is a real, editable budget with a four-step guide. You choose where to save it. F1 opens the keyboard reference. Future updates are under Help → Updates. Your workbooks are preserved.

For Omarchy on Linux x86_64. Setup uses the GTK runtime shipped with Omarchy; it downloads the app and installs missing runtime dependencies through the system package manager. No compiler or GitHub login is needed.

The optional bar widget is installed separately:

omarchy plugin add https://github.com/tcballard/OmaSheets.git --enable

Development builds are CI prereleases, separate from signed production releases. INSTALL.md explains both channels and removal.

Open a workbook and choose Ask Agent from the OmaSheets window or Omarchy bar. OmaSheets asks omarchy agent prompt to start an agent session with the user's configured default agent. The agent starts from the path-free omasheets://session resource, which carries the live selection and workflow contract. Agents without OmaSheets MCP discovery can use the equivalent bounded omasheets agent-session JSON command bridge; neither surface exposes publication. Flagship v0.0.2 workflows are formula explanation, bounded data cleanup, variance analysis, cross-sheet reconciliation, checked summaries, formatting-only cleanup, workbook-wide audit, and audit-backed management summaries with pivots and charts.

Commands

omasheets
omasheets doctor
omasheets launch workbook.omasheets
omasheets launch workbook.xlsx
omasheets open workbook.xls
omasheets window workbook.xlsx
omasheets select workbook.xlsx
omasheets convert workbook.xls
omasheets status --json
omasheets agent-session
omasheets agent-session resource
omasheets agent-session tools
omasheets mcp serve
omasheets lok status
omasheets lok render workbook.xls --output /tmp/workbook-tile.ppm

The real Omarchy, Wayland and LibreOffice release pass remains in docs/ACCEPTANCE.md.

omasheets and omasheets launch without a path open the start screen, with New, Open, Import Excel and compatibility-window actions. New workbooks start with one sheet, 1,000 rows and 26 columns, at the filename you choose. Enter, Tab or Ctrl+S commits a cell draft; Escape cancels it. Close and reopen the .omasheets file to continue working. File → Export writes a new XLSX workbook or the current sheet as CSV or Parquet and displays the conversion report. Creation and export refuse to overwrite existing files.

omasheets launch FILE is the production desktop-entry boundary. It opens native .omasheets documents in the Qt grid and compatibility formats in the LibreOfficeKit window. The Qt grid starts an authenticated native service on demand, reuses an existing user service when one is already running, and stops only the transient service it owns after the last launched grid closes. Closing the window that originally started the service does not interrupt other open grids. Failed service startup is bounded and cleans up the attempted process.

The native workbook window source is in native/libreofficekit/. It embeds LibreOfficeKit's interactive tile engine in OmaSheets-owned GTK chrome with scrolling, selection, keyboard editing, sheets, zoom and save-copy controls. CI exercises the installed XDG binary under Xvfb; real Omarchy/Wayland acceptance is still a separate release gate.

The native window and MCP server share one immutable workbook session. Agents can observe its bounded, path-free selection and viewport through omasheets://session, inspect the relevant cells, and stage semantic changes; they cannot drive pointer/keyboard input or publish workbook bytes.

While the window is open, those reads and plans are based on private LibreOfficeKit save-copies of the exact in-memory document, including unsaved work. Agents never mutate the visible document; verified output still goes through local review and live plans are copy-only.

Verified proposals appear inside the native window as an OmaSheets-owned diff overlay. It shows the agent's goal, explanation, assumptions and purpose groups beside cited audit findings and bounded cell-level before/after values, formulas, formatting, charts and pivots. It flags destructive operations and truncation and never paints changes into LibreOfficeKit. The user can hide it or explicitly approve a new, no-clobber workbook copy from the overlay.

Status

Early development. v0.0.2 has an automated Arch install/native/agent/uninstall gate and has received maintainer hands-on testing. The repository does not yet record evidence for every item in the complete Omarchy/Wayland release runbook, and no perfect Excel compatibility claim is made.

Large-workbook performance claims are likewise evidence-gated. The dependency-free performance harness generates truthful dense, sparse and formula workloads and records Linux process-tree RSS, PSS and USS rather than relying on a single sparse used-range smoke file.