shortcutxl 0.2.25 → 0.2.27

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.2.27]
+
+- **Friendlier setup experience** — First-time install now shows plain-language step names (e.g. "Calculation Engine" instead of "Python Packages") and a prominent green prompt when Excel needs to be opened.
+
+## [0.2.26]
+
+- **Workbook scope** — When multiple workbooks are open, ShortcutXL now asks which ones to focus on. The agent only sees the workbooks you select, keeping context tight and responses more relevant.
+- **Connections** — Connect external data sources via `/connect`. Supports databases (Snowflake, Postgres, Oracle, MySQL), SaaS APIs (Salesforce, Notion, HubSpot, Airtable), and cloud drives. Credentials are stored in the OS keychain.
+- **Skill sync** — Download shared skills from the cloud with `/download-skills`.
+- **Skill creator** — A built-in eval-driven workflow for authoring, testing, and improving custom skills.
+- **Fixed local install issues** — Resolved a shell path bug that could prevent the CLI from launching after a global npm install.
+
 ## [0.2.22]
 
 - **Tool extensions** — Build custom tools that the agent can call.

package/agent-docs/api-reference.json

@@ -131,9 +131,7 @@
         "getSettings": {
           "signature": "getSettings(): Promise<WorkbookSettings>",
           "docstring": "Get workbook-level settings.",
-          "usedTypes": [
-            "WorkbookSettings"
-          ]
+          "usedTypes": ["WorkbookSettings"]
         },
         "setSettings": {
           "signature": "setSettings(updates: Partial<WorkbookSettings>): Promise<void>",
@@ -198,9 +196,7 @@
         "names.get": {
           "signature": "names.get(name: string, scope?: string | undefined): Promise<NamedRangeInfo | null>",
           "docstring": "Get a named range by name.\n@param - The name to look up.\n@param - Optional sheet name scope. Omit for workbook-scoped names.\n@returns The named range info, or null if not found.",
-          "usedTypes": [
-            "NamedRangeInfo"
-          ]
+          "usedTypes": ["NamedRangeInfo"]
         },
         "names.getRange": {
           "signature": "names.getRange(name: string, scope?: string | undefined): Promise<NamedRangeReference | null>",
@@ -220,9 +216,7 @@
         "names.list": {
           "signature": "names.list(): Promise<NamedRangeInfo[]>",
           "docstring": "List all named ranges in the workbook.\n@returns Array of named range info objects.",
-          "usedTypes": [
-            "NamedRangeInfo"
-          ]
+          "usedTypes": ["NamedRangeInfo"]
         },
         "names.createFromSelection": {
           "signature": "names.createFromSelection(sheetId: string, range: CellRange, options: CreateNamesFromSelectionOptions): Promise<CreateNamesResult>",
@@ -322,16 +316,12 @@
         "styles.getTableStyles": {
           "signature": "styles.getTableStyles(): Promise<TableStyleInfo[]>",
           "docstring": "Get all custom table styles.",
-          "usedTypes": [
-            "TableStyleInfo"
-          ]
+          "usedTypes": ["TableStyleInfo"]
         },
         "styles.createTableStyle": {
           "signature": "styles.createTableStyle(config: TableStyleConfig): Promise<string>",
           "docstring": "Create a custom table style. Returns the style name/ID.",
-          "usedTypes": [
-            "TableStyleConfig"
-          ]
+          "usedTypes": ["TableStyleConfig"]
         },
         "styles.updateTableStyle": {
           "signature": "styles.updateTableStyle(name: string, updates: Partial<TableStyleConfig>): Promise<void>",
@@ -376,9 +366,7 @@
         "setCell": {
           "signature": "setCell(address: string, value: any, options?: CellWriteOptions | undefined): Promise<void>",
           "docstring": "Set a cell value by A1 address.",
-          "usedTypes": [
-            "CellWriteOptions"
-          ]
+          "usedTypes": ["CellWriteOptions"]
         },
         "setDateValue": {
           "signature": "setDateValue(row: number, col: number, date: Date): Promise<void>",
@@ -393,16 +381,12 @@
         "getCell": {
           "signature": "getCell(address: string): Promise<CellData>",
           "docstring": "Get cell data by A1 address.",
-          "usedTypes": [
-            "CellData"
-          ]
+          "usedTypes": ["CellData"]
         },
         "getRange": {
           "signature": "getRange(range: string): Promise<CellData[][]>",
           "docstring": "Get a 2D array of cell data for a range (A1 notation).",
-          "usedTypes": [
-            "CellData"
-          ]
+          "usedTypes": ["CellData"]
         },
         "setRange": {
           "signature": "setRange(range: string, values: any[][]): Promise<void>",
@@ -427,16 +411,12 @@
         "getRawCellData": {
           "signature": "getRawCellData(address: string, includeFormula?: boolean | undefined): Promise<RawCellData>",
           "docstring": "Get raw cell data (value, formula, format, borders, etc.) by A1 address.",
-          "usedTypes": [
-            "RawCellData"
-          ]
+          "usedTypes": ["RawCellData"]
         },
         "getRawRangeData": {
           "signature": "getRawRangeData(range: string, includeFormula?: boolean | undefined): Promise<RawCellData[][]>",
           "docstring": "Get raw data for a range as a 2D array.",
-          "usedTypes": [
-            "RawCellData"
-          ]
+          "usedTypes": ["RawCellData"]
         },
         "getRangeWithIdentity": {
           "signature": "getRangeWithIdentity(startRow: number, startCol: number, endRow: number, endCol: number): Promise<IdentifiedCellData[]>",
@@ -456,9 +436,7 @@
         "summarize": {
           "signature": "summarize(options?: SummaryOptions | undefined): Promise<string>",
           "docstring": "Get a sheet overview summary for agent context.",
-          "usedTypes": [
-            "SummaryOptions"
-          ]
+          "usedTypes": ["SummaryOptions"]
         },
         "getUsedRange": {
           "signature": "getUsedRange(): Promise<string | null>",
@@ -488,10 +466,7 @@
         "regexSearch": {
           "signature": "regexSearch(patterns: string[], options?: SearchOptions | undefined): Promise<SearchResult[]>",
           "docstring": "Search cells using regex patterns.",
-          "usedTypes": [
-            "SearchOptions",
-            "SearchResult"
-          ]
+          "usedTypes": ["SearchOptions", "SearchResult"]
         },
         "getDisplayValue": {
           "signature": "getDisplayValue(address: string): Promise<string>",
@@ -501,9 +476,7 @@
         "sortRange": {
           "signature": "sortRange(range: string, options: SortOptions): Promise<void>",
           "docstring": "Sort a range by the specified options.",
-          "usedTypes": [
-            "SortOptions"
-          ]
+          "usedTypes": ["SortOptions"]
         },
         "autoFill": {
           "signature": "autoFill(sourceRange: string, targetRange: string, fillMode?: AutoFillMode | undefined): Promise<AutoFillResult>",
@@ -543,9 +516,7 @@
         "getSelectionAggregates": {
           "signature": "getSelectionAggregates(ranges: CellRange[]): Promise<AggregateResult>",
           "docstring": "Get aggregates (SUM, COUNT, AVG, MIN, MAX) for selected ranges.",
-          "usedTypes": [
-            "AggregateResult"
-          ]
+          "usedTypes": ["AggregateResult"]
         },
         "formatValues": {
           "signature": "formatValues(entries: FormatEntry[]): Promise<string[]>",
@@ -555,9 +526,7 @@
         "goalSeek": {
           "signature": "goalSeek(targetCell: string, targetValue: number, changingCell: string): Promise<GoalSeekResult>",
           "docstring": "Run a goal seek to find the input value that produces a target result.",
-          "usedTypes": [
-            "GoalSeekResult"
-          ]
+          "usedTypes": ["GoalSeekResult"]
         },
         "isVisible": {
           "signature": "isVisible(): boolean",
@@ -617,16 +586,12 @@
         "charts.add": {
           "signature": "charts.add(config: ChartConfig): Promise<string>",
           "docstring": "Add a chart to the sheet. Returns the chart ID.",
-          "usedTypes": [
-            "ChartConfig"
-          ]
+          "usedTypes": ["ChartConfig"]
         },
         "charts.get": {
           "signature": "charts.get(chartId: string): Promise<Chart | null>",
           "docstring": "Get a chart by ID, or null if not found.",
-          "usedTypes": [
-            "Chart"
-          ]
+          "usedTypes": ["Chart"]
         },
         "charts.update": {
           "signature": "charts.update(chartId: string, updates: Partial<ChartConfig>): Promise<void>",
@@ -641,9 +606,7 @@
         "charts.list": {
           "signature": "charts.list(): Promise<Chart[]>",
           "docstring": "List all charts in the sheet.",
-          "usedTypes": [
-            "Chart"
-          ]
+          "usedTypes": ["Chart"]
         },
         "charts.duplicate": {
           "signature": "charts.duplicate(chartId: string): Promise<string>",
@@ -663,9 +626,7 @@
         "charts.setType": {
           "signature": "charts.setType(chartId: string, type: ChartType, subType?: string | undefined): Promise<void>",
           "docstring": "Set a chart's type and optional sub-type.",
-          "usedTypes": [
-            "ChartType"
-          ]
+          "usedTypes": ["ChartType"]
         },
         "charts.getCount": {
           "signature": "charts.getCount(): Promise<number>",
@@ -675,9 +636,7 @@
         "charts.getByName": {
           "signature": "charts.getByName(name: string): Promise<Chart | null>",
           "docstring": "Find a chart by its name, or null if not found.",
-          "usedTypes": [
-            "Chart"
-          ]
+          "usedTypes": ["Chart"]
         },
         "charts.bringToFront": {
           "signature": "charts.bringToFront(chartId: string): Promise<void>",
@@ -887,9 +846,7 @@
         "filters.getAutoFilter": {
           "signature": "filters.getAutoFilter(): Promise<FilterState | null>",
           "docstring": "Get the current auto-filter state.\n@returns The filter state, or null if no auto-filter is set",
-          "usedTypes": [
-            "FilterState"
-          ]
+          "usedTypes": ["FilterState"]
         },
         "filters.getForRange": {
           "signature": "filters.getForRange(range: CellRange): Promise<{ id: string; } | null>",
@@ -949,9 +906,7 @@
         "filters.list": {
           "signature": "filters.list(): Promise<FilterInfo[]>",
           "docstring": "List all filters in the sheet.\n@returns Array of filter info objects",
-          "usedTypes": [
-            "FilterInfo"
-          ]
+          "usedTypes": ["FilterInfo"]
         },
         "filters.listDetails": {
           "signature": "filters.listDetails(): Promise<FilterDetailInfo[]>",
@@ -1166,9 +1121,7 @@
         "pivots.add": {
           "signature": "pivots.add(config: Omit<PivotTableConfig, \"id\" | \"createdAt\" | \"updatedAt\">): Promise<PivotTableConfig>",
           "docstring": "Create a new pivot table on this worksheet.\n@param - Pivot table configuration (source, fields, placements).\nThe `id`, `createdAt`, and `updatedAt` fields are auto-generated and should be omitted.\n@returns The created pivot table configuration (with generated id, timestamps)",
-          "usedTypes": [
-            "PivotTableConfig"
-          ]
+          "usedTypes": ["PivotTableConfig"]
         },
         "pivots.addWithSheet": {
           "signature": "pivots.addWithSheet(sheetName: string, config: Omit<PivotTableConfig, \"id\" | \"createdAt\" | \"updatedAt\">): Promise<{ sheetId: string; config: PivotTableConfig; }>",
@@ -1188,9 +1141,7 @@
         "pivots.get": {
           "signature": "pivots.get(name: string): Promise<PivotTableHandle | null>",
           "docstring": "Get a pivot table handle by name.\n@param - Pivot table name\n@returns A handle for the pivot table, or null if not found",
-          "usedTypes": [
-            "PivotTableHandle"
-          ]
+          "usedTypes": ["PivotTableHandle"]
         },
         "pivots.addField": {
           "signature": "pivots.addField(pivotId: string, fieldId: string, area: PivotFieldArea, options?: { position?: number | undefined; aggregateFunction?: AggregateFunction | undefined; sortOrder?: SortOrder | undefined; displayName?: string | undefined; } | undefined): Promise<void>",
@@ -1350,9 +1301,7 @@
         "protection.protect": {
           "signature": "protection.protect(password?: string | undefined, options?: ProtectionOptions | undefined): Promise<void>",
           "docstring": "Protect the sheet with an optional password and granular permission options.\n@param - Optional password to require for unprotection\n@param - Granular permissions (e.g., allowSort, allowFormatCells)",
-          "usedTypes": [
-            "ProtectionOptions"
-          ]
+          "usedTypes": ["ProtectionOptions"]
         },
         "protection.unprotect": {
           "signature": "protection.unprotect(password?: string | undefined): Promise<boolean>",
@@ -1377,9 +1326,7 @@
         "protection.getConfig": {
           "signature": "protection.getConfig(): Promise<ProtectionConfig>",
           "docstring": "Get the full protection configuration for the sheet.\n@returns Protection configuration including status and permission flags",
-          "usedTypes": [
-            "ProtectionConfig"
-          ]
+          "usedTypes": ["ProtectionConfig"]
         },
         "settings.get": {
           "signature": "settings.get(): Promise<SheetSettingsInfo>",
@@ -1404,9 +1351,7 @@
         "slicers.add": {
           "signature": "slicers.add(config: SlicerConfig): Promise<string>",
           "docstring": "Create a new slicer on this worksheet.\n@param - Slicer configuration (table, column, position)\n@returns The ID of the created slicer",
-          "usedTypes": [
-            "SlicerConfig"
-          ]
+          "usedTypes": ["SlicerConfig"]
         },
         "slicers.remove": {
           "signature": "slicers.remove(slicerId: string): Promise<void>",
@@ -1416,9 +1361,7 @@
         "slicers.list": {
           "signature": "slicers.list(): Promise<SlicerInfo[]>",
           "docstring": "List all slicers on this worksheet.\n@returns Array of slicer summary information",
-          "usedTypes": [
-            "SlicerInfo"
-          ]
+          "usedTypes": ["SlicerInfo"]
         },
         "slicers.get": {
           "signature": "slicers.get(slicerId: string): Promise<Slicer | null>",
@@ -1428,9 +1371,7 @@
         "slicers.getItems": {
           "signature": "slicers.getItems(slicerId: string): Promise<SlicerItem[]>",
           "docstring": "Get the items (values) available in a slicer.\n@param - ID of the slicer\n@returns Array of slicer items with selection state",
-          "usedTypes": [
-            "SlicerItem"
-          ]
+          "usedTypes": ["SlicerItem"]
         },
         "slicers.setSelection": {
           "signature": "slicers.setSelection(slicerId: string, selectedItems: CellValue[]): Promise<void>",
@@ -1455,9 +1396,7 @@
         "slicers.getState": {
           "signature": "slicers.getState(slicerId: string): Promise<SlicerState>",
           "docstring": "Get the enriched runtime state of a slicer.\n@param - ID of the slicer\n@returns Enriched slicer state including computed items and connection status",
-          "usedTypes": [
-            "SlicerState"
-          ]
+          "usedTypes": ["SlicerState"]
         },
         "sparklines.add": {
           "signature": "sparklines.add(cell: { row: number; col: number; }, dataRange: CellRange, type: SparklineType, options?: CreateSparklineOptions | undefined): Promise<Sparkline>",
@@ -1592,16 +1531,12 @@
         "structure.textToColumns": {
           "signature": "structure.textToColumns(range: string, options: TextToColumnsOptions): Promise<void>",
           "docstring": "Split text in a column into multiple columns.",
-          "usedTypes": [
-            "TextToColumnsOptions"
-          ]
+          "usedTypes": ["TextToColumnsOptions"]
         },
         "structure.removeDuplicates": {
           "signature": "structure.removeDuplicates(range: string, columns: number[], hasHeaders?: boolean | undefined): Promise<RemoveDuplicatesResult>",
           "docstring": "Remove duplicate rows in a range.",
-          "usedTypes": [
-            "RemoveDuplicatesResult"
-          ]
+          "usedTypes": ["RemoveDuplicatesResult"]
         },
         "structure.merge": {
           "signature": "structure.merge(range: string): Promise<void>",
@@ -1616,9 +1551,7 @@
         "structure.getMergedRegions": {
           "signature": "structure.getMergedRegions(): Promise<MergedRegion[]>",
           "docstring": "Get all merged regions in the sheet.",
-          "usedTypes": [
-            "MergedRegion"
-          ]
+          "usedTypes": ["MergedRegion"]
         },
         "structure.getMergeAtCell": {
           "signature": "structure.getMergeAtCell(address: string): Promise<CellRange | null>",
@@ -1628,24 +1561,17 @@
         "tables.add": {
           "signature": "tables.add(range: string, options?: TableOptions | undefined): Promise<TableInfo>",
           "docstring": "Create a new table from a cell range.\n@param - A1-style range string (e.g. \"A1:D10\")\n@param - Optional table creation settings (name, headers, style)\n@returns The created table information",
-          "usedTypes": [
-            "TableInfo",
-            "TableOptions"
-          ]
+          "usedTypes": ["TableInfo", "TableOptions"]
         },
         "tables.get": {
           "signature": "tables.get(name: string): Promise<TableInfo | null>",
           "docstring": "Get a table by name.\n\nTables are workbook-scoped, so the name is unique across all sheets.\n@param - Table name\n@returns Table information, or null if not found",
-          "usedTypes": [
-            "TableInfo"
-          ]
+          "usedTypes": ["TableInfo"]
         },
         "tables.list": {
           "signature": "tables.list(): Promise<TableInfo[]>",
           "docstring": "List all tables in this worksheet.\n@returns Array of table information objects",
-          "usedTypes": [
-            "TableInfo"
-          ]
+          "usedTypes": ["TableInfo"]
         },
         "tables.remove": {
           "signature": "tables.remove(name: string): Promise<void>",
@@ -1665,9 +1591,7 @@
         "tables.getAtCell": {
           "signature": "tables.getAtCell(row: number, col: number): Promise<TableInfo | null>",
           "docstring": "Get the table at a specific cell position, if one exists.\n@param - Row index (0-based)\n@param - Column index (0-based)\n@returns Table information, or null if no table exists at that cell",
-          "usedTypes": [
-            "TableInfo"
-          ]
+          "usedTypes": ["TableInfo"]
         },
         "tables.clearFilters": {
           "signature": "tables.clearFilters(tableName: string): Promise<void>",
@@ -1737,9 +1661,7 @@
         "validation.set": {
           "signature": "validation.set(address: string, rule: ValidationRule): Promise<void>",
           "docstring": "Set a validation rule on a cell or range.\n@param - A1-style cell or range address (e.g. \"A1\", \"A1:B5\")\n@param - Validation rule to apply",
-          "usedTypes": [
-            "ValidationRule"
-          ]
+          "usedTypes": ["ValidationRule"]
         },
         "validation.remove": {
           "signature": "validation.remove(address: string): Promise<void>",
@@ -1749,9 +1671,7 @@
         "validation.get": {
           "signature": "validation.get(address: string): Promise<ValidationRule | null>",
           "docstring": "Get the validation rule for a cell.\n@param - A1-style cell address\n@returns The validation rule, or null if none",
-          "usedTypes": [
-            "ValidationRule"
-          ]
+          "usedTypes": ["ValidationRule"]
         },
         "validation.getDropdownItems": {
           "signature": "validation.getDropdownItems(address: string): Promise<string[]>",
@@ -1761,9 +1681,7 @@
         "validation.list": {
           "signature": "validation.list(): Promise<ValidationRule[]>",
           "docstring": "List all validation rules on the sheet.\n@returns Array of validation rules",
-          "usedTypes": [
-            "ValidationRule"
-          ]
+          "usedTypes": ["ValidationRule"]
         },
         "validation.clear": {
           "signature": "validation.clear(range: string): Promise<void>",
@@ -1823,9 +1741,7 @@
         "view.getViewOptions": {
           "signature": "view.getViewOptions(): Promise<ViewOptions>",
           "docstring": "Get the current view options (gridlines, headings).\n@returns Current view options",
-          "usedTypes": [
-            "ViewOptions"
-          ]
+          "usedTypes": ["ViewOptions"]
         },
         "view.getTabColor": {
           "signature": "view.getTabColor(): Promise<string | null>",
@@ -2038,4 +1954,4 @@
     }
   },
   "generated": "2026-03-26T06:07:37.111Z"
-}
+}