- commit
- 1c69c950ff31dcd455eec11c7f2aad0f59f9843c
- parent
- 2621da12cc778cb1a88b6bd2a6ab6735f1f484cd
- author
- Dami <dami.etoile@gmail.com>
- kind
- docs risk score 0.4 of 3, Jev's estimate
| M | README.md | 7 | ++++++- |
| M | cmd/ | 2 | +- |
| M | docs/ | 2 | +- |
| M | docs/ | 2 | +- |
| M | internal/ | 2 | +- |
@@ -44,7 +44,12 @@ rest: building from a clone, importing files, `012 serve` and settings.
4444 ([charts](docs/sheets/charts.md)).4545 - **Files**: a diff-friendly JSON format, import from CSV, TSV, JSON,4646 nushell's NUON, XLSX, SQLite, Parquet and Lotus 1-2-3, export to CSV,47- TSV, JSON, NUON, XLSX and SQLite ([files](docs/files/README.md)).47+ TSV, JSON, NUON, XLSX, SQLite and a self-contained web page with its48+ charts as SVG ([files](docs/files/README.md)).49+- **For agents**: `012 describe`, `get`, `set --dry-run` and `recalc`50+ with JSON results, a Claude Code skill, and `012 mcp`, an MCP server51+ whose writes go through the same checks as yours, with views52+ of ranges and charts in the chat ([agents](docs/agents/README.md)).4853 - **A stage in a pipeline**: `ls | sheet | where size > 1kb` edits a4954 table on the terminal and sends it on with its types, through the5055 nushell module `012 nu --install-module` installs, or as@@ -9,7 +9,7 @@ description: Read, change, check and share 012 spreadsheet workbooks (.012 files
99 formulas, tables, charts and nushell notebooks. Work on them with the1010 `012` command, never by editing the file's JSON: `012 set` checks every1111 entry as the screen does and saves atomically, and its changes show in12-`012 diff` and undo like a person's.12+`012 diff` like a person's.1313 1414 ## Look before you read1515 @@ -7,7 +7,7 @@ sidebar_position: 1
77 88 Coding agents and assistants work on `.012` workbooks through the same99 operations people use: every change is typed into cells as the screen10-types it, checked by the same rules, made as one undoable step and10+types it, checked by the same rules, made as one change and1111 shown by [`012 diff`](../files/git.md#012-diff) like anyone's. Nothing1212 agents do runs a program or reaches the network unless they were1313 started with the flags that allow it, as for scripts.@@ -10,7 +10,7 @@ server on one workbook, over standard input and output, so any MCP host
1010 (Claude Code, Claude Desktop, editors) can read and change it. It is the1111 same code as [the commands](README.md#with-a-shell): reads are1212 `012 describe` and `012 get`, and every write is typed through the13-checks `012 set` makes, as one undoable change, saved atomically at13+checks `012 set` makes, as one change, saved atomically at1414 once.1515 1616 ```mermaid@@ -74,7 +74,7 @@ const instructions = `This server works on one 012 spreadsheet workbook (.012 fi
7474 Call describe first: it lists the sheets, their used ranges, guessed header rows and column names, tables, named ranges, charts and notebooks.7575 References are written as in formulas: B7, A1:C9, Q3!B7, 'Q3 plan'!A1:C9, a named range, a table (Sales, Sales[Amount]) or a sheet name for the whole sheet; without a sheet name, the sheet shown when the file was saved.7676 Inputs are what a person types, in en-US form: 1.5, =SUM(A1:A6), $1,200, 12%, 2026-09-29. Formulas are Google Sheets'.77-Writes are checked as typing is (formulas must parse, validation rules, protected ranges) and each call is one undoable change, saved at once; pass dry_run to see the change without making it. Call evaluate to try a formula without writing it.`77+Writes are checked as typing is (formulas must parse, validation rules, protected ranges) and each call is one change, saved at once; pass dry_run to see the change without making it. Call evaluate to try a formula without writing it.`7878 7979 // rawSchemas infer json.RawMessage, a value already in JSON, as any8080 // value.