# Univer

Univer is an offline-first spreadsheet collaboration stack built for agents and humans. It lets AI agents work directly with formulas, ranges, pivots, and charts locally, turning every change into a Git-style commit that you can review, diff, merge, and roll back.

## One-sentence definition

Univer Runner is an offline-first spreadsheet collaboration stack for agents and humans, with Git-shaped review workflow and remote workbook replay.

## Core capabilities

- Local-first editing: Agents and humans create, edit, persist, stage, and commit spreadsheet work entirely on their machine before any network interaction.
- Git-shaped workflow: Structured review, approval, diff, merge, and rollback for spreadsheet changes.
- Hosted review: Publish reviewable revisions so stakeholders can comment and approve without reading raw repo internals.
- Remote workbook replay: Replay approved lineage to a remote workbook, with safe catch-up after remote drift.
- Runtime SDK: A stable runtime contract that lets terminal agents, copilots, internal tools, and web apps operate on workbook state without browser-level automation.

## Key architectural rules

- Truth ownership beats menu shape: Boundaries are drawn around who owns durable state and state transitions, not around UI commands.
- Shells orchestrate, kernels own: App shells handle entry points and presentation; kernel packages own contracts, data models, and final interpretation.
- Review closure is not origin execution: An approved hosted review does not mean the remote workbook has accepted the change until an explicit replay is executed.

## Primary actors

- Alice (local builder): Creates, writes, persists, stages, commits, and pushes work from local shells.
- Bob (hosted reviewer): Opens hosted review, comments on revisions, and approves work.
- Charlie (local builder): Binds to an existing remote workbook, pulls a clean baseline, and continues local-first work safely.
- David (remote workbook editor): Changes the remote workbook through MCP-facing surfaces, creating remote drift that local users later reconcile.

## Important boundaries

- Workspace truth: Local persistent workbook state owned by the workspace substrate.
- Repo truth: Repo objects, workflow truth, review sessions, replay runs, owned by `sheet-git-kernel`.
- Hosted review truth: Reviews, revisions, comments, deliveries, owned by `sheet-review-core`.
- Sync and replay policy: Readiness checks, pull decisions, replay planning, owned by `git-shaped-sync-core`.
- Runtime contract: Stable execution contract between shells and the workbook runtime, owned by `univer-runtime-sdk`.

## Getting started

- Setup: Run `npx -y skills add dream-num/skills -g --all` and ensure `univer-cli` is installed (`npm install -g univer-cli@latest`).
- Update: `npx skills update` (skills) and `univer update` (CLI).
- After setup, agents can use Univer to inspect workbooks, make structured spreadsheet changes, review diffs, and hand results back for approval.
- Contact: `developer@univer.ai`

## Links

- Website: https://univer.ai
- Agent setup: https://univer.ai/SKILL.md
- Skills repo: https://github.com/dream-num/skills/tree/main/skills/univer-cli