@vectojs/numera-cli

Safe, local-first workbook automation for Numera.

@vectojs/numera-cli is the command-line boundary for inspecting and editing offline Numera workbooks. It uses the published Core document model and guarded XLSX adapter; it does not start a browser, render a UI, contact a service, or perform an implicit in-place write.

Install

npm install --global @vectojs/numera-cli

Commands

numera inspect budget.xlsx --json
numera get budget.xlsx "Sheet 1" A1:C3 --json
numera set budget.xlsx "Sheet 1" B2 --number 42 --output budget-edited.xlsx

set always requires a distinct output path. A successful command writes an atomically replaced output file, leaving the input untouched.

All command output is JSON so shell scripts and future agent tools can consume it without screen scraping. get accepts either one A1 address or a normalized range such as A1:C3.

set accepts exactly one explicit value mode: --text, --number, --boolean true|false, or --formula. Formula source gets a leading = when needed; no input type is inferred from a text argument.

Formats

• .xlsx reads and writes through @vectojs/numera-xlsx.
• .numera.json uses Numera Core’s versioned snapshot codec.
• .csv contains one selected worksheet and cannot represent workbook-wide formatting or multiple sheets.

Verify

bun install
bun run verify
npm pack --dry-run

License

MIT © 2026 Xuepoo