# ShortcutXL

An AI agent that lives on your computer and has Excel superpowers. Made by the [Shortcut](https://shortcut.ai) team.

## Install

### 1. Open Command Prompt or PowerShell and install Node.js

```bash
winget install OpenJS.NodeJS.LTS --source winget
```

Then close and reopen your terminal.

### 2. Install ShortcutXL

```bash
npm install -g shortcutxl
```

### 3. Launch ShortcutXL

Type `shortcut` in your terminal:

```bash
shortcut
```

## Requirements

- **Windows 10/11** with **Excel 2016+** (64-bit)
- **Node.js >= 20**

## Capabilities

- **Data lives locally** — Workbooks, files, and skills stay on your machine.
- **Multi-workbook operations** — Read and write across multiple open workbooks simultaneously.
- **Deep feature control** — Pivots, charts, sensitivity tables, iterative recalculations, and more.
- **VBA access** — Read, write, and run macros. Create VBA modules programmatically.
- **File system access** — Save to arbitrary paths, open files from disk, export PDFs.
- **Extensible** — Integrate any API or data source by adding a skill file or a custom tool extension.
- **User-defined functions (UDFs)** — Custom Excel formulas powered by Python for live data, calculations, or database queries.
- **External data connections** — ODBC, OLE DB, QueryTables, Power Query.

## Documentation

[Full documentation (PDF)](https://unpkg.com/shortcutxl/user-docs/dist/shortcutxl-docs.pdf)
