Do not pass entire react query result to provider because it is not a stable reference

Auto-generated by VRT workflow

PR: #6766

.cursor/rules/pr-and-commit.mdc

@@ -1,74 +0,0 @@
----
-description: Rules for AI-generated commits and pull requests
-globs:
-alwaysApply: true
----
-
-# PR and Commit Rules for AI Agents
-
-Canonical source: `.github/agents/pr-and-commit-rules.md`
-
-## Commit Rules
-
-### [AI] Prefix Requirement
-
-**ALL commit messages MUST be prefixed with `[AI]`.** This is a mandatory requirement with no exceptions.
-
-**Examples:**
-
-- `[AI] Fix type error in account validation`
-- `[AI] Add support for new transaction categories`
-- `Fix type error in account validation` (MISSING PREFIX - NOT ALLOWED)
-- `Add support for new transaction categories` (MISSING PREFIX - NOT ALLOWED)
-
-### Git Safety Rules
-
-- **Never** update git config
-- **Never** run destructive git operations (force push, hard reset) unless the user explicitly requests it
-- **Never** skip hooks (`--no-verify`, `--no-gpg-sign`)
-- **Never** force push to `main`/`master`
-- **Never** commit unless explicitly asked by the user
-
-## Pre-Commit Quality Checklist
-
-Before committing, ensure all of the following:
-
-- [ ] Commit message is prefixed with `[AI]`
-- [ ] `yarn typecheck` passes
-- [ ] `yarn lint:fix` has been run
-- [ ] Relevant tests pass
-- [ ] User-facing strings are translated
-- [ ] Code style conventions followed (see `AGENTS.md` for full style guide)
-
-## Pull Request Rules
-
-### [AI] Prefix Requirement
-
-**ALL pull request titles MUST be prefixed with `[AI]`.** This is a mandatory requirement with no exceptions.
-
-**Examples:**
-
-- `[AI] Fix type error in account validation`
-- `[AI] Add support for new transaction categories`
-- `Fix type error in account validation` (MISSING PREFIX - NOT ALLOWED)
-
-### Labels
-
-Add the **"AI generated"** label to all AI-created pull requests.
-
-### PR Template: Do Not Fill In
-
-- **NEVER fill in the PR template** (`.github/PULL_REQUEST_TEMPLATE.md`). Leave all blank spaces and placeholder comments as-is.
-- **Exception**: If a human **explicitly asks** you to fill out the PR template, then fill it out **in Chinese** (简体中文).
-
-## Quick-Reference Workflow
-
-1. Make your changes
-2. Run `yarn typecheck` — fix any errors
-3. Run `yarn lint:fix` — fix any remaining lint errors
-4. Run relevant tests (`yarn test` for all, or workspace-specific)
-5. Stage files and commit with `[AI]` prefix — do not skip hooks
-6. When creating a PR:
-   - Use `[AI]` prefix in the title
-   - Add the `"AI generated"` label
-   - Leave the PR template blank (do not fill it in)

.github/actions/ai-generated-release-notes/pr-details.js

@@ -37,14 +37,12 @@ async function getPRDetails() {
     console.log('- PR Author:', pr.user.login);
     console.log('- PR Title:', pr.title);
     console.log('- Base Branch:', pr.base.ref);
-    console.log('- Head Branch:', pr.head.ref);
 
     const result = {
       number: pr.number,
       author: pr.user.login,
       title: pr.title,
       baseBranch: pr.base.ref,
-      headBranch: pr.head.ref,
     };
 
     setOutput('result', JSON.stringify(result));

.github/actions/check-migrations.js

@@ -1,14 +1,14 @@
+#!/usr/bin/env node
+
 // overview:
 // 1. Identify the migrations in packages/loot-core/migrations/* on `master` and HEAD
 // 2. Make sure that any new migrations on HEAD are dated after the latest migration on `master`.
 
-import { spawnSync } from 'child_process';
-import path from 'path';
-import { fileURLToPath } from 'url';
+const { spawnSync } = require('child_process');
+const path = require('path');
 
 const migrationsDir = path.join(
-  path.dirname(fileURLToPath(import.meta.url)),
-  '..',
+  __dirname,
   '..',
   '..',
   'packages',
@@ -16,7 +16,7 @@ const migrationsDir = path.join(
   'migrations',
 );
 
-function readMigrations(ref: string) {
+function readMigrations(ref) {
   const { stdout } = spawnSync('git', [
     'ls-tree',
     '--name-only',

.github/actions/docs-spelling/expect.txt

@@ -2,7 +2,6 @@ Abanca
 ABNAMRO
 ABNANL
 Activo
-actualrc
 AESUDEF
 ALZEY
 Anglais
@@ -111,8 +110,8 @@ KBCBE
 Keycloak
 Khurozov
 KORT
-Kreditbank
 KRW
+Kreditbank
 lage
 LHV
 LHVBEE

.github/agents/pr-and-commit-rules.md

@@ -1,70 +0,0 @@
-# PR and Commit Rules for AI Agents
-
-This is the single source of truth for all commit and pull request rules that AI agents must follow when working with Actual Budget.
-
-## Commit Rules
-
-### [AI] Prefix Requirement
-
-**ALL commit messages MUST be prefixed with `[AI]`.** This is a mandatory requirement with no exceptions.
-
-**Examples:**
-
-- `[AI] Fix type error in account validation`
-- `[AI] Add support for new transaction categories`
-- `Fix type error in account validation` (MISSING PREFIX - NOT ALLOWED)
-- `Add support for new transaction categories` (MISSING PREFIX - NOT ALLOWED)
-
-### Git Safety Rules
-
-- **Never** update git config
-- **Never** run destructive git operations (force push, hard reset) unless the user explicitly requests it
-- **Never** skip hooks (`--no-verify`, `--no-gpg-sign`)
-- **Never** force push to `main`/`master`
-- **Never** commit unless explicitly asked by the user
-
-## Pre-Commit Quality Checklist
-
-Before committing, ensure all of the following:
-
-- [ ] Commit message is prefixed with `[AI]`
-- [ ] `yarn typecheck` passes
-- [ ] `yarn lint:fix` has been run
-- [ ] Relevant tests pass
-- [ ] User-facing strings are translated
-- [ ] Code style conventions followed (see `AGENTS.md` for full style guide)
-
-## Pull Request Rules
-
-### [AI] Prefix Requirement
-
-**ALL pull request titles MUST be prefixed with `[AI]`.** This is a mandatory requirement with no exceptions.
-
-**Examples:**
-
-- `[AI] Fix type error in account validation`
-- `[AI] Add support for new transaction categories`
-- `Fix type error in account validation` (MISSING PREFIX - NOT ALLOWED)
-
-### Labels
-
-Add the **"AI generated"** label to all AI-created pull requests. This helps maintainers understand the nature of the contribution.
-
-### PR Template: Do Not Fill In
-
-- **NEVER fill in the PR template** (`.github/PULL_REQUEST_TEMPLATE.md`). Leave all blank spaces and placeholder comments as-is. Humans are expected to fill in the Description, Related issue(s), Testing, and Checklist sections.
-- **Exception**: If a human **explicitly asks** you to fill out the PR template, then fill it out **in Chinese**, using Chinese characters (简体中文) for all content you add.
-
-## Quick-Reference Workflow
-
-Follow these steps when committing and creating PRs:
-
-1. Make your changes
-2. Run `yarn typecheck` — fix any errors
-3. Run `yarn lint:fix` — fix any remaining lint errors
-4. Run relevant tests (`yarn test` for all, or workspace-specific)
-5. Stage files and commit with `[AI]` prefix — do not skip hooks
-6. When creating a PR:
-   - Use `[AI]` prefix in the title
-   - Add the `"AI generated"` label
-   - Leave the PR template blank (do not fill it in)

.github/workflows/ai-generated-release-notes.yml

@@ -41,12 +41,21 @@ jobs:
           GITHUB_REPOSITORY: ${{ github.repository }}
           GITHUB_EVENT_ISSUE_NUMBER: ${{ github.event.issue.number }}
 
+      - name: Check if PR targets master branch
+        if: steps.check-first-comment.outputs.result == 'true' && steps.pr-details.outputs.result != 'null'
+        id: check-base-branch
+        run: |
+          BASE_BRANCH=$(echo '${{ steps.pr-details.outputs.result }}' | jq -r '.baseBranch')
+          echo "Base branch: $BASE_BRANCH"
+          if [ "$BASE_BRANCH" = "master" ]; then
+            echo "targets_master=true" >> $GITHUB_OUTPUT
+          else
+            echo "targets_master=false" >> $GITHUB_OUTPUT
+            echo "PR does not target master branch, skipping release notes generation"
+          fi
+
       - name: Check if release notes file already exists
-        if: >-
-          steps.check-first-comment.outputs.result == 'true' &&
-          steps.pr-details.outputs.result != 'null' &&
-          fromJSON(steps.pr-details.outputs.result).baseBranch == 'master' &&
-          !startsWith(fromJSON(steps.pr-details.outputs.result).headBranch, 'release/')
+        if: steps.check-first-comment.outputs.result == 'true' && steps.pr-details.outputs.result != 'null' && steps.check-base-branch.outputs.targets_master == 'true'
         id: check-release-notes-exists
         run: node .github/actions/ai-generated-release-notes/check-release-notes-exists.js
         env:

.github/workflows/build.yml

@@ -81,31 +81,6 @@ jobs:
           name: build-stats
           path: packages/desktop-client/build-stats
 
-  cli:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-      - name: Set up environment
-        uses: ./.github/actions/setup
-        with:
-          download-translations: 'false'
-      - name: Build CLI
-        run: yarn build:cli
-      - name: Create package tgz
-        run: cd packages/cli && yarn pack && mv package.tgz actual-cli.tgz
-      - name: Prepare bundle stats artifact
-        run: cp packages/cli/dist/stats.json cli-stats.json
-      - name: Upload Build
-        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
-        with:
-          name: actual-cli
-          path: packages/cli/actual-cli.tgz
-      - name: Upload CLI bundle stats
-        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
-        with:
-          name: cli-build-stats
-          path: cli-stats.json
-
   server:
     runs-on: ubuntu-latest
     steps:

.github/workflows/check.yml

@@ -60,9 +60,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-      - name: Set up environment
-        uses: ./.github/actions/setup
+      - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
         with:
-          download-translations: 'false'
+          node-version: 22
       - name: Check migrations
-        run: yarn workspace @actual-app/ci-actions tsx bin/check-migrations.ts
+        run: node ./.github/actions/check-migrations.js

.github/workflows/docker-edge.yml

@@ -87,8 +87,8 @@ jobs:
       - name: Test that the docker image boots
         run: |
           docker run --detach --network=host actualbudget/actual-server-testing
-          sleep 10
-          curl --fail -sS -LI -w '%{http_code}\n' --retry 20 --retry-delay 1 --retry-connrefused localhost:5006
+          sleep 5
+          curl --fail -sS -LI -w '%{http_code}\n' --retry 10 --retry-delay 1 --retry-connrefused localhost:5006
 
       # This will use the cache from the earlier build step and not rebuild the image
       # https://docs.docker.com/build/ci/github-actions/test-before-push/

.github/workflows/electron-master.yml

@@ -156,3 +156,53 @@ jobs:
             -NoStatus `
             -AutoCommit `
             -Force
+
+  publish-flathub:
+    needs: build
+    runs-on: ubuntu-22.04
+    if: ${{ github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v') }}
+    steps:
+      - name: Download Linux artifacts
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
+        with:
+          name: actual-electron-ubuntu-22.04
+
+      - name: Calculate AppImage SHA256
+        id: appimage_sha256
+        run: |
+          APPIMAGE_X64_SHA256=$(sha256sum Actual-linux-x86_64.AppImage | awk '{ print $1 }')
+          APPIMAGE_ARM64_SHA256=$(sha256sum Actual-linux-arm64.AppImage | awk '{ print $1 }')
+          echo "APPIMAGE_X64_SHA256=$APPIMAGE_X64_SHA256" >> "$GITHUB_ENV"
+          echo "APPIMAGE_ARM64_SHA256=$APPIMAGE_ARM64_SHA256" >> "$GITHUB_ENV"
+
+      - name: Checkout Flathub repo
+        uses: actions/checkout@v6
+        with:
+          repository: flathub/com.actualbudget.actual
+          token: ${{ secrets.FLATHUB_GITHUB_TOKEN }}
+
+      - name: Update manifest with new SHA256
+        run: |
+          # Replace x86_64 entry
+          sed -i "/x86_64.AppImage/{n;s|sha256:.*|sha256: ${{ env.APPIMAGE_X64_SHA256 }}|}" com.actualbudget.actual.yml
+          sed -i "/x86_64.AppImage/s|url:.*|url: https://github.com/actualbudget/actual/releases/download/v${{ needs.build.outputs.version }}/Actual-linux-x86_64.AppImage|" com.actualbudget.actual.yml
+
+          # Replace arm64 entry
+          sed -i "/arm64.AppImage/{n;s|sha256:.*|sha256: ${{ env.APPIMAGE_ARM64_SHA256 }}|}" com.actualbudget.actual.yml
+          sed -i "/arm64.AppImage/s|url:.*|url: https://github.com/actualbudget/actual/releases/download/v${{ needs.build.outputs.version }}/Actual-linux-arm64.AppImage|" com.actualbudget.actual.yml
+
+          cat com.actualbudget.actual.yml
+
+      - name: Create PR in Flathub repo
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.FLATHUB_GITHUB_TOKEN }}
+          commit-message: 'Update Actual flatpak to version ${{ needs.build.outputs.version }}'
+          branch: 'release/${{ needs.build.outputs.version }}'
+          draft: true
+          title: 'Update Actual flatpak to version ${{ needs.build.outputs.version }}'
+          body: |
+            This PR updates the Actual desktop flatpak to version ${{ needs.build.outputs.version }}.
+
+            :link: [View release notes](https://actualbudget.org/blog/release-${{ needs.build.outputs.version }})
+          reviewers: 'jfdoming,MatissJanis,youngcw' # The core team that have accepted the collaborator access to the Flathub repo

.github/workflows/publish-flathub.yml

@@ -1,126 +0,0 @@
-name: Publish Flathub
-
-defaults:
-  run:
-    shell: bash
-
-on:
-  release:
-    types: [published]
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag (e.g. v25.3.0)'
-        required: true
-        type: string
-
-concurrency:
-  group: publish-flathub
-  cancel-in-progress: false
-
-jobs:
-  publish-flathub:
-    runs-on: ubuntu-22.04
-    steps:
-      - name: Resolve version
-        id: resolve_version
-        env:
-          EVENT_NAME: ${{ github.event_name }}
-          RELEASE_TAG: ${{ github.event.release.tag_name }}
-          INPUT_TAG: ${{ inputs.tag }}
-        run: |
-          if [[ "$EVENT_NAME" == "release" ]]; then
-            TAG="$RELEASE_TAG"
-          else
-            TAG="$INPUT_TAG"
-          fi
-
-          if [[ -z "$TAG" ]]; then
-            echo "::error::No tag provided"
-            exit 1
-          fi
-
-          # Validate tag format (v-prefixed semver, e.g. v25.3.0 or v1.2.3-beta.1)
-          if [[ ! "$TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$ ]]; then
-            echo "::error::Invalid tag format: $TAG (expected v-prefixed semver, e.g. v25.3.0)"
-            exit 1
-          fi
-
-          VERSION="${TAG#v}"
-          echo "tag=$TAG" >> "$GITHUB_OUTPUT"
-          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-          echo "Resolved tag=$TAG version=$VERSION"
-
-      - name: Verify release assets exist
-        env:
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          TAG="${{ steps.resolve_version.outputs.tag }}"
-
-          echo "Checking release assets for tag $TAG..."
-          ASSETS=$(gh api "repos/${{ github.repository }}/releases/tags/$TAG" --jq '.assets[].name')
-
-          echo "Found assets:"
-          echo "$ASSETS"
-
-          if ! echo "$ASSETS" | grep -qx "Actual-linux-x86_64.AppImage"; then
-            echo "::error::Missing asset: Actual-linux-x86_64.AppImage"
-            exit 1
-          fi
-
-          if ! echo "$ASSETS" | grep -qx "Actual-linux-arm64.AppImage"; then
-            echo "::error::Missing asset: Actual-linux-arm64.AppImage"
-            exit 1
-          fi
-
-          echo "All required AppImage assets found."
-
-      - name: Calculate AppImage SHA256 (streamed)
-        run: |
-          VERSION="${{ steps.resolve_version.outputs.version }}"
-          BASE_URL="https://github.com/${{ github.repository }}/releases/download/v${VERSION}"
-
-          echo "Streaming x86_64 AppImage to compute SHA256..."
-          APPIMAGE_X64_SHA256=$(curl -fSL "${BASE_URL}/Actual-linux-x86_64.AppImage" | sha256sum | awk '{ print $1 }')
-          echo "x86_64 SHA256: $APPIMAGE_X64_SHA256"
-
-          echo "Streaming arm64 AppImage to compute SHA256..."
-          APPIMAGE_ARM64_SHA256=$(curl -fSL "${BASE_URL}/Actual-linux-arm64.AppImage" | sha256sum | awk '{ print $1 }')
-          echo "arm64 SHA256: $APPIMAGE_ARM64_SHA256"
-
-          echo "APPIMAGE_X64_SHA256=$APPIMAGE_X64_SHA256" >> "$GITHUB_ENV"
-          echo "APPIMAGE_ARM64_SHA256=$APPIMAGE_ARM64_SHA256" >> "$GITHUB_ENV"
-
-      - name: Checkout Flathub repo
-        uses: actions/checkout@v6
-        with:
-          repository: flathub/com.actualbudget.actual
-          token: ${{ secrets.FLATHUB_GITHUB_TOKEN }}
-
-      - name: Update manifest with new version
-        run: |
-          VERSION="${{ steps.resolve_version.outputs.version }}"
-
-          # Replace x86_64 entry
-          sed -i "/x86_64.AppImage/{n;s|sha256:.*|sha256: ${{ env.APPIMAGE_X64_SHA256 }}|}" com.actualbudget.actual.yml
-          sed -i "/x86_64.AppImage/s|url:.*|url: https://github.com/actualbudget/actual/releases/download/v${VERSION}/Actual-linux-x86_64.AppImage|" com.actualbudget.actual.yml
-
-          # Replace arm64 entry
-          sed -i "/arm64.AppImage/{n;s|sha256:.*|sha256: ${{ env.APPIMAGE_ARM64_SHA256 }}|}" com.actualbudget.actual.yml
-          sed -i "/arm64.AppImage/s|url:.*|url: https://github.com/actualbudget/actual/releases/download/v${VERSION}/Actual-linux-arm64.AppImage|" com.actualbudget.actual.yml
-
-          echo "Updated manifest:"
-          cat com.actualbudget.actual.yml
-
-      - name: Create PR in Flathub repo
-        uses: peter-evans/create-pull-request@v7
-        with:
-          token: ${{ secrets.FLATHUB_GITHUB_TOKEN }}
-          commit-message: 'Update Actual flatpak to version ${{ steps.resolve_version.outputs.version }}'
-          branch: 'release/${{ steps.resolve_version.outputs.version }}'
-          title: 'Update Actual flatpak to version ${{ steps.resolve_version.outputs.version }}'
-          body: |
-            This PR updates the Actual desktop flatpak to version ${{ steps.resolve_version.outputs.version }}.
-
-            :link: [View release notes](https://actualbudget.org/blog/release-${{ steps.resolve_version.outputs.version }})
-          reviewers: 'jfdoming,MatissJanis,youngcw'

.github/workflows/publish-nightly-npm-packages.yml

@@ -20,27 +20,19 @@ jobs:
       - name: Update package versions
         run: |
           # Get new nightly versions
-          NEW_CORE_VERSION=$(node ./packages/ci-actions/bin/get-next-package-version.js --package-json ./packages/loot-core/package.json --type nightly)
           NEW_WEB_VERSION=$(node ./packages/ci-actions/bin/get-next-package-version.js --package-json ./packages/desktop-client/package.json --type nightly)
           NEW_SYNC_VERSION=$(node ./packages/ci-actions/bin/get-next-package-version.js --package-json ./packages/sync-server/package.json --type nightly)
           NEW_API_VERSION=$(node ./packages/ci-actions/bin/get-next-package-version.js --package-json ./packages/api/package.json --type nightly)
-          NEW_CLI_VERSION=$(node ./packages/ci-actions/bin/get-next-package-version.js --package-json ./packages/cli/package.json --type nightly)
 
           # Set package versions
-          npm version $NEW_CORE_VERSION --no-git-tag-version --workspace=@actual-app/core --no-workspaces-update
           npm version $NEW_WEB_VERSION --no-git-tag-version --workspace=@actual-app/web --no-workspaces-update
           npm version $NEW_SYNC_VERSION --no-git-tag-version --workspace=@actual-app/sync-server --no-workspaces-update
           npm version $NEW_API_VERSION --no-git-tag-version --workspace=@actual-app/api --no-workspaces-update
-          npm version $NEW_CLI_VERSION --no-git-tag-version --workspace=@actual-app/cli --no-workspaces-update
 
       - name: Yarn install
         run: |
           yarn install
 
-      - name: Pack the core package
-        run: |
-          yarn workspace @actual-app/core pack --filename @actual-app/core.tgz
-
       - name: Build Server & Web
         run: yarn build:server
 
@@ -56,23 +48,14 @@ jobs:
         run: |
           yarn workspace @actual-app/api pack --filename @actual-app/api.tgz
 
-      - name: Build CLI
-        run: yarn workspace @actual-app/cli build
-
-      - name: Pack the cli package
-        run: |
-          yarn workspace @actual-app/cli pack --filename @actual-app/cli.tgz
-
       - name: Upload package artifacts
         uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
         with:
           name: npm-packages
           path: |
-            packages/loot-core/@actual-app/core.tgz
             packages/desktop-client/@actual-app/web.tgz
             packages/sync-server/@actual-app/sync-server.tgz
             packages/api/@actual-app/api.tgz
-            packages/cli/@actual-app/cli.tgz
 
   publish:
     runs-on: ubuntu-latest
@@ -93,12 +76,6 @@ jobs:
           node-version: 22
           registry-url: 'https://registry.npmjs.org'
 
-      - name: Publish Core
-        run: |
-          npm publish loot-core/@actual-app/core.tgz --access public --tag nightly
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
       - name: Publish Web
         run: |
           npm publish desktop-client/@actual-app/web.tgz --access public --tag nightly
@@ -116,9 +93,3 @@ jobs:
           npm publish api/@actual-app/api.tgz --access public --tag nightly
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Publish CLI
-        run: |
-          npm publish cli/@actual-app/cli.tgz --access public --tag nightly
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/publish-npm-packages.yml

@@ -16,10 +16,6 @@ jobs:
       - name: Set up environment
         uses: ./.github/actions/setup
 
-      - name: Pack the core package
-        run: |
-          yarn workspace @actual-app/core pack --filename @actual-app/core.tgz
-
       - name: Build Web
         run: yarn build:server
 
@@ -35,23 +31,14 @@ jobs:
         run: |
           yarn workspace @actual-app/api pack --filename @actual-app/api.tgz
 
-      - name: Build CLI
-        run: yarn workspace @actual-app/cli build
-
-      - name: Pack the cli package
-        run: |
-          yarn workspace @actual-app/cli pack --filename @actual-app/cli.tgz
-
       - name: Upload package artifacts
         uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
         with:
           name: npm-packages
           path: |
-            packages/loot-core/@actual-app/core.tgz
             packages/desktop-client/@actual-app/web.tgz
             packages/sync-server/@actual-app/sync-server.tgz
             packages/api/@actual-app/api.tgz
-            packages/cli/@actual-app/cli.tgz
 
   publish:
     runs-on: ubuntu-latest
@@ -72,12 +59,6 @@ jobs:
           node-version: 22
           registry-url: 'https://registry.npmjs.org'
 
-      - name: Publish Core
-        run: |
-          npm publish loot-core/@actual-app/core.tgz --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
       - name: Publish Web
         run: |
           npm publish desktop-client/@actual-app/web.tgz --access public
@@ -95,9 +76,3 @@ jobs:
           npm publish api/@actual-app/api.tgz --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Publish CLI
-        run: |
-          npm publish cli/@actual-app/cli.tgz --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/size-compare.yml

@@ -57,13 +57,6 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
           checkName: api
           ref: ${{github.base_ref}}
-      - name: Wait for ${{github.base_ref}} CLI build to succeed
-        uses: fountainhead/action-wait-for-check@5a908a24814494009c4bb27c242ea38c93c593be # v1.2.0
-        id: master-cli-build
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          checkName: cli
-          ref: ${{github.base_ref}}
 
       - name: Wait for PR build to succeed
         uses: fountainhead/action-wait-for-check@5a908a24814494009c4bb27c242ea38c93c593be # v1.2.0
@@ -79,16 +72,9 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
           checkName: api
           ref: ${{github.event.pull_request.head.sha}}
-      - name: Wait for CLI PR build to succeed
-        uses: fountainhead/action-wait-for-check@5a908a24814494009c4bb27c242ea38c93c593be # v1.2.0
-        id: wait-for-cli-build
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          checkName: cli
-          ref: ${{github.event.pull_request.head.sha}}
 
       - name: Report build failure
-        if: steps.wait-for-web-build.outputs.conclusion == 'failure' || steps.wait-for-api-build.outputs.conclusion == 'failure' || steps.wait-for-cli-build.outputs.conclusion == 'failure'
+        if: steps.wait-for-web-build.outputs.conclusion == 'failure' || steps.wait-for-api-build.outputs.conclusion == 'failure'
         run: |
           echo "Build failed on PR branch or ${{github.base_ref}}"
           exit 1
@@ -129,23 +115,6 @@ jobs:
           name: api-build-stats
           path: head
           allow_forks: true
-      - name: Download CLI build artifact from ${{github.base_ref}}
-        uses: dawidd6/action-download-artifact@ac66b43f0e6a346234dd65d4d0c8fbb31cb316e5 # v11
-        with:
-          branch: ${{github.base_ref}}
-          workflow: build.yml
-          workflow_conclusion: '' # ignore the conclusion of the workflow, since we already checked it
-          name: cli-build-stats
-          path: base
-      - name: Download CLI stats from PR
-        uses: dawidd6/action-download-artifact@ac66b43f0e6a346234dd65d4d0c8fbb31cb316e5 # v11
-        with:
-          pr: ${{github.event.pull_request.number}}
-          workflow: build.yml
-          workflow_conclusion: '' # ignore the conclusion of the workflow, since we already checked it
-          name: cli-build-stats
-          path: head
-          allow_forks: true
       - name: Strip content hashes from stats files
         run: |
           if [ -f ./head/web-stats.json ]; then
@@ -167,11 +136,9 @@ jobs:
             --base desktop-client=./base/web-stats.json \
             --base loot-core=./base/loot-core-stats.json \
             --base api=./base/api-stats.json \
-            --base cli=./base/cli-stats.json \
             --head desktop-client=./head/web-stats.json \
             --head loot-core=./head/loot-core-stats.json \
             --head api=./head/api-stats.json \
-            --head cli=./head/cli-stats.json \
             --identifier combined \
             --format pr-body > bundle-stats-comment.md
       - name: Post combined bundle stats comment

.gitignore

@@ -33,9 +33,7 @@ packages/desktop-electron/dist
 packages/desktop-electron/loot-core
 packages/desktop-client/service-worker
 packages/plugins-service/dist
-packages/component-library/dist
 packages/loot-core/lib-dist
-**/.tsbuildinfo
 packages/sync-server/coverage
 bundle.desktop.js
 bundle.desktop.js.map
@@ -81,10 +79,3 @@ build/
 
 *storybook.log
 storybook-static
-
-# cli config when testing locally
-.actualrc.json
-.actualrc
-.actualrc.yaml
-.actualrc.yml
-actual.config.js

.oxfmtrc.json

@@ -10,7 +10,7 @@
       "builtin",
       "external",
       "loot-core",
-      ["parent", "subpath"],
+      "parent",
       "sibling",
       "index",
       "desktop-client"
@@ -22,7 +22,7 @@
       },
       {
         "groupName": "loot-core",
-        "elementNamePattern": ["loot-core/**", "@actual-app/core/**"]
+        "elementNamePattern": ["loot-core/**"]
       },
       {
         "groupName": "desktop-client",

.oxlintrc.json

@@ -101,18 +101,8 @@
     "typescript/no-var-requires": "error",
     // we want to allow unions such as "{ name: DbAccount['name'] | DbPayee['name'] }"
     "typescript/no-duplicate-type-constituents": "off",
-    // we want to allow unions such as "string | 'network' | 'file-key-mismatch'"
-    "typescript/no-redundant-type-constituents": "off",
     "typescript/await-thenable": "error",
-    "typescript/no-floating-promises": "error",
-    "typescript/require-array-sort-compare": "error",
-    "typescript/unbound-method": "error",
-    "typescript/no-for-in-array": "error",
-    "typescript/restrict-template-expressions": "error",
-    "typescript/no-misused-spread": "warn", // TODO: enable this
-    "typescript/no-base-to-string": "warn", // TODO: enable this
-    "typescript/no-unsafe-unary-minus": "warn", // TODO: enable this
-    "typescript/no-unsafe-type-assertion": "warn", // TODO: enable this
+    "typescript/no-floating-promises": "warn", // TODO: covert to error
 
     // Import rules
     "import/consistent-type-specifier-style": "error",

AGENTS.md

@@ -44,9 +44,25 @@ yarn start:desktop
 
 ### ⚠️ CRITICAL REQUIREMENT: AI-Generated Commit Messages and PR Titles
 
-**ALL commit messages and PR titles MUST be prefixed with `[AI]`.** No exceptions.
+**THIS IS A MANDATORY REQUIREMENT THAT MUST BE FOLLOWED WITHOUT EXCEPTION:**
 
-See [PR and Commit Rules](.github/agents/pr-and-commit-rules.md) for the full specification, including git safety rules, pre-commit checklist, and PR workflow.
+- **ALL commit messages MUST be prefixed with `[AI]`**
+- **ALL pull request titles MUST be prefixed with `[AI]`**
+
+**Examples:**
+
+- ✅ `[AI] Fix type error in account validation`
+- ✅ `[AI] Add support for new transaction categories`
+- ❌ `Fix type error in account validation` (MISSING PREFIX - NOT ALLOWED)
+- ❌ `Add support for new transaction categories` (MISSING PREFIX - NOT ALLOWED)
+
+**This requirement applies to:**
+
+- Every single commit message created by AI agents
+- Every single pull request title created by AI agents
+- No exceptions are permitted
+
+**This is a hard requirement that agents MUST follow. Failure to include the `[AI]` prefix is a violation of these instructions.**
 
 ### Task Orchestration with Lage
 
@@ -84,7 +100,7 @@ The core application logic that runs on any platform.
 
   ```bash
   # Run all loot-core tests
-  yarn workspace @actual-app/core run test
+  yarn workspace loot-core run test
 
   # Or run tests across all packages using lage
   yarn test
@@ -219,7 +235,7 @@ yarn test
 yarn test:debug
 
 # Run tests for a specific package
-yarn workspace @actual-app/core run test
+yarn workspace loot-core run test
 ```
 
 **E2E Tests (Playwright)**
@@ -298,7 +314,6 @@ Always run `yarn typecheck` before committing.
 
 **React Patterns:**
 
-- The project uses **React Compiler** (`babel-plugin-react-compiler`) in the desktop-client. The compiler auto-memoizes component bodies, so you can omit manual `useCallback`, `useMemo`, and `React.memo` when adding or refactoring code; prefer inline callbacks and values unless a stable identity is required by a non-compiled dependency.
 - Don't use `React.FunctionComponent` or `React.FC` - type props directly
 - Don't use `React.*` patterns - use named imports instead
 - Use `<Link>` instead of `<a>` tags
@@ -345,7 +360,13 @@ Always maintain newlines between import groups.
 
 **Git Commands:**
 
-See [PR and Commit Rules](.github/agents/pr-and-commit-rules.md) for complete git safety rules, commit message requirements, and PR workflow.
+- **MANDATORY: ALL commit messages MUST be prefixed with `[AI]`** - This is a hard requirement with no exceptions
+- **MANDATORY: ALL pull request titles MUST be prefixed with `[AI]`** - This is a hard requirement with no exceptions
+- Never update git config
+- Never run destructive git operations (force push, hard reset) unless explicitly requested
+- Never skip hooks (--no-verify, --no-gpg-sign)
+- Never force push to main/master
+- Never commit unless explicitly asked
 
 ## File Structure Patterns
 
@@ -544,7 +565,7 @@ Icons in `packages/component-library/src/icons/` are auto-generated. Don't manua
 
 Before committing changes, ensure:
 
-- [ ] Commit and PR rules followed (see [PR and Commit Rules](.github/agents/pr-and-commit-rules.md))
+- [ ] **MANDATORY: Commit message is prefixed with `[AI]`** - This is a hard requirement with no exceptions
 - [ ] `yarn typecheck` passes
 - [ ] `yarn lint:fix` has been run
 - [ ] Relevant tests pass
@@ -557,7 +578,17 @@ Before committing changes, ensure:
 
 ## Pull Request Guidelines
 
-See [PR and Commit Rules](.github/agents/pr-and-commit-rules.md) for complete PR creation rules, including title prefix requirements, labeling, and PR template handling.
+When creating pull requests:
+
+- **MANDATORY PREFIX REQUIREMENT**: **ALL pull request titles MUST be prefixed with `[AI]`** - This is a hard requirement that MUST be followed without exception
+  - ✅ Correct: `[AI] Fix type error in account validation`
+  - ❌ Incorrect: `Fix type error in account validation` (MISSING PREFIX - NOT ALLOWED)
+- **AI-Generated PRs**: If you create a PR using AI assistance, add the **"AI generated"** label to the pull request. This helps maintainers understand the nature of the contribution.
+
+### PR Template: Do Not Fill In
+
+- **NEVER fill in the PR template** (`.github/PULL_REQUEST_TEMPLATE.md`). Leave all blank spaces and placeholder comments as-is. We expect **humans** to fill in the Description, Related issue(s), Testing, and Checklist sections.
+- **Exception**: If a human **explicitly asks** you to fill out the PR template, then fill it out **in Chinese**, using Chinese characters (简体中文) for all content you add.
 
 ## Code Review Guidelines
 
@@ -625,7 +656,7 @@ Standard commands documented in `package.json` scripts and the Quick Start secti
 
 - `yarn lint` / `yarn lint:fix` (uses oxlint + oxfmt)
 - `yarn test` (lage across all workspaces)
-- `yarn typecheck` (tsgo + lage typecheck)
+- `yarn typecheck` (tsc + lage typecheck)
 
 ### Testing and previewing the app
 

CLAUDE.md

@@ -1,2 +0,0 @@
-@AGENTS.md
-@.github/agents/pr-and-commit-rules.md

bin/package-browser

@@ -17,7 +17,7 @@ packages/desktop-client/bin/remove-untranslated-languages
 export NODE_OPTIONS="--max-old-space-size=4096"
 
 yarn workspace plugins-service build
-yarn workspace @actual-app/core build:browser
+yarn workspace loot-core build:browser
 yarn workspace @actual-app/web build:browser
 
 echo "packages/desktop-client/build"

bin/package-electron

@@ -51,17 +51,14 @@ fi
 export NODE_OPTIONS="--max-old-space-size=4096"
 
 yarn workspace plugins-service build
-yarn workspace @actual-app/core build:node
+yarn workspace loot-core build:node
 yarn workspace @actual-app/web build --mode=desktop # electron specific build
 
 # required for running the sync-server server
-yarn workspace @actual-app/core build:browser
+yarn workspace loot-core build:browser
 yarn workspace @actual-app/web build:browser
 yarn workspace @actual-app/sync-server build
 
-# Emit @actual-app/core declarations so desktop-electron (which includes typings/window.ts) can build
-yarn workspace @actual-app/core exec tsgo -p tsconfig.json
-
 yarn workspace desktop-electron update-client
 
 (

lage.config.js

@@ -3,7 +3,6 @@ module.exports = {
   pipeline: {
     typecheck: {
       type: 'npmScript',
-      dependsOn: ['^typecheck'],
     },
     test: {
       type: 'npmScript',
@@ -17,7 +16,6 @@ module.exports = {
     },
     build: {
       type: 'npmScript',
-      dependsOn: ['^build'],
       cache: true,
       options: {
         outputGlob: ['lib-dist/**', 'dist/**', 'build/**'],

package.json

@@ -25,23 +25,21 @@
     "start:desktop": "yarn desktop-dependencies && npm-run-all --parallel 'start:desktop-*'",
     "start:docs": "yarn workspace docs start",
     "desktop-dependencies": "npm-run-all --parallel rebuild-electron build:browser-backend build:plugins-service",
-    "start:desktop-node": "yarn workspace @actual-app/core watch:node",
+    "start:desktop-node": "yarn workspace loot-core watch:node",
     "start:desktop-client": "yarn workspace @actual-app/web watch",
     "start:desktop-server-client": "yarn workspace @actual-app/web build:browser",
     "start:desktop-electron": "yarn workspace desktop-electron watch",
     "start:browser": "yarn workspace plugins-service build-dev && npm-run-all --parallel 'start:browser-*'",
     "start:service-plugins": "yarn workspace plugins-service watch",
-    "start:browser-backend": "yarn workspace @actual-app/core watch:browser",
+    "start:browser-backend": "yarn workspace loot-core watch:browser",
     "start:browser-frontend": "yarn workspace @actual-app/web start:browser",
     "start:storybook": "yarn workspace @actual-app/components start:storybook",
-    "build": "lage build",
-    "build:browser-backend": "yarn workspace @actual-app/core build:browser",
+    "build:browser-backend": "yarn workspace loot-core build:browser",
     "build:server": "yarn build:browser && yarn workspace @actual-app/sync-server build",
     "build:browser": "./bin/package-browser",
     "build:desktop": "./bin/package-electron",
     "build:plugins-service": "yarn workspace plugins-service build",
     "build:api": "yarn workspace @actual-app/api build",
-    "build:cli": "yarn build --scope=@actual-app/cli",
     "build:docs": "yarn workspace docs build",
     "build:storybook": "yarn workspace @actual-app/components build:storybook",
     "deploy:docs": "yarn workspace docs deploy",
@@ -55,11 +53,11 @@
     "vrt": "yarn workspace @actual-app/web run vrt",
     "vrt:docker": "./bin/run-vrt",
     "rebuild-electron": "./node_modules/.bin/electron-rebuild -m ./packages/loot-core",
-    "rebuild-node": "yarn workspace @actual-app/core rebuild",
-    "lint": "oxfmt --check . && oxlint --type-aware --quiet",
-    "lint:fix": "oxfmt . && oxlint --fix --type-aware --quiet",
+    "rebuild-node": "yarn workspace loot-core rebuild",
+    "lint": "oxfmt --check . && oxlint --type-aware",
+    "lint:fix": "oxfmt . && oxlint --fix --type-aware",
     "install:server": "yarn workspaces focus @actual-app/sync-server --production",
-    "typecheck": "tsgo -p tsconfig.root.json --noEmit && lage typecheck",
+    "typecheck": "tsc -p tsconfig.root.json --noEmit && lage typecheck",
     "jq": "./node_modules/node-jq/bin/jq",
     "prepare": "husky"
   },
@@ -67,7 +65,6 @@
     "@octokit/rest": "^22.0.1",
     "@types/node": "^22.19.10",
     "@types/prompts": "^2.4.9",
-    "@typescript/native-preview": "^7.0.0-dev.20260309.1",
     "baseline-browser-mapping": "^2.9.19",
     "cross-env": "^10.1.0",
     "eslint": "^9.39.2",
@@ -90,7 +87,6 @@
     "typescript": "^5.9.3"
   },
   "resolutions": {
-    "adm-zip": "patch:adm-zip@npm%3A0.5.16#~/.yarn/patches/adm-zip-npm-0.5.16-4556fea098.patch",
     "rollup": "4.40.1",
     "socks": ">=2.8.3"
   },
@@ -99,7 +95,7 @@
       "oxfmt --no-error-on-unmatched-pattern"
     ],
     "*.{js,mjs,jsx,ts,tsx}": [
-      "oxlint --fix --type-aware --quiet"
+      "oxlint --fix --type-aware"
     ]
   },
   "browserslist": [

packages/api/app/query.js

@@ -1,7 +1,4 @@
 class Query {
-  /** @type {import('loot-core/shared/query').QueryState} */
-  state;
-
   constructor(state) {
     this.state = {
       filterExpressions: state.filterExpressions || [],

packages/api/index.ts

@@ -3,18 +3,26 @@ import type {
   RequestInit as FetchInit,
 } from 'node-fetch';
 
-import { init as initLootCore } from '@actual-app/core/server/main';
-import type { InitConfig, lib } from '@actual-app/core/server/main';
+// loot-core types
+import type { InitConfig } from 'loot-core/server/main';
 
+// oxlint-disable-next-line typescript/ban-ts-comment
+// @ts-ignore: bundle not available until we build it
+import * as bundle from './app/bundle.api.js';
+import * as injected from './injected';
 import { validateNodeVersion } from './validateNodeVersion';
 
+let actualApp: null | typeof bundle.lib;
+export const internal = bundle.lib;
+
 export * from './methods';
 export * as utils from './utils';
 
-/** @deprecated Please use return value of `init` instead */
-export let internal: typeof lib | null = null;
-
 export async function init(config: InitConfig = {}) {
+  if (actualApp) {
+    return;
+  }
+
   validateNodeVersion();
 
   if (!globalThis.fetch) {
@@ -25,19 +33,21 @@ export async function init(config: InitConfig = {}) {
     };
   }
 
-  internal = await initLootCore(config);
-  return internal;
+  await bundle.init(config);
+  actualApp = bundle.lib;
+
+  injected.override(bundle.lib.send);
+  return bundle.lib;
 }
 
 export async function shutdown() {
-  if (internal) {
+  if (actualApp) {
     try {
-      await internal.send('sync');
+      await actualApp.send('sync');
     } catch {
       // most likely that no budget is loaded, so the sync failed
     }
-
-    await internal.send('close-budget');
-    internal = null;
+    await actualApp.send('close-budget');
+    actualApp = null;
   }
 }

packages/api/injected.js

@@ -0,0 +1,7 @@
+// TODO: comment on why it works this way
+
+export let send;
+
+export function override(sendImplementation) {
+  send = sendImplementation;
+}

packages/api/methods.test.ts

@@ -1,29 +1,10 @@
 import * as fs from 'fs/promises';
 import * as path from 'path';
 
-import { vi } from 'vitest';
-
-import type { RuleEntity } from '@actual-app/core/types/models';
+import type { RuleEntity } from 'loot-core/types/models';
 
 import * as api from './index';
 
-// In tests we run from source; loot-core's API fs uses __dirname (for the built dist/).
-// Mock the fs so path constants point at loot-core package root where migrations live.
-vi.mock(
-  '../loot-core/src/platform/server/fs/index.api',
-  async importOriginal => {
-    const actual = (await importOriginal()) as Record<string, unknown>;
-    const pathMod = await import('path');
-    const lootCoreRoot = pathMod.join(__dirname, '..', 'loot-core');
-    return {
-      ...actual,
-      migrationsPath: pathMod.join(lootCoreRoot, 'migrations'),
-      bundledDatabasePath: pathMod.join(lootCoreRoot, 'default-db.sqlite'),
-      demoBudgetPath: pathMod.join(lootCoreRoot, 'demo-budget'),
-    };
-  },
-);
-
 const budgetName = 'test-budget';
 
 global.IS_TESTING = true;

packages/api/methods.ts

@@ -6,16 +6,16 @@ import type {
   APIPayeeEntity,
   APIScheduleEntity,
   APITagEntity,
-} from '@actual-app/core/server/api-models';
-import { lib } from '@actual-app/core/server/main';
-import type { Query } from '@actual-app/core/shared/query';
-import type { ImportTransactionsOpts } from '@actual-app/core/types/api-handlers';
-import type { Handlers } from '@actual-app/core/types/handlers';
+} from 'loot-core/server/api-models';
+import type { Query } from 'loot-core/shared/query';
+import type { Handlers } from 'loot-core/types/handlers';
 import type {
   ImportTransactionEntity,
   RuleEntity,
   TransactionEntity,
-} from '@actual-app/core/types/models';
+} from 'loot-core/types/models';
+
+import * as injected from './injected';
 
 export { q } from './app/query';
 
@@ -23,7 +23,7 @@ function send<K extends keyof Handlers, T extends Handlers[K]>(
   name: K,
   args?: Parameters<T>[0],
 ): Promise<Awaited<ReturnType<T>>> {
-  return lib.send(name, args);
+  return injected.send(name, args);
 }
 
 export async function runImport(
@@ -126,6 +126,11 @@ export function addTransactions(
   });
 }
 
+export type ImportTransactionsOpts = {
+  defaultCleared?: boolean;
+  dryRun?: boolean;
+};
+
 export function importTransactions(
   accountId: APIAccountEntity['id'],
   transactions: ImportTransactionEntity[],

packages/api/package.json

@@ -9,41 +9,29 @@
   ],
   "main": "dist/index.js",
   "types": "@types/index.d.ts",
-  "exports": {
-    ".": {
-      "development": "./index.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "publishConfig": {
-    "exports": {
-      ".": {
-        "types": "./@types/index.d.ts",
-        "default": "./dist/index.js"
-      }
-    }
-  },
   "scripts": {
-    "build": "vite build",
-    "test": "vitest --run",
-    "typecheck": "tsgo -b && tsc-strict"
+    "build:app": "yarn workspace loot-core build:api",
+    "build:crdt": "yarn workspace @actual-app/crdt build",
+    "build:node": "tsc && tsc-alias",
+    "build:migrations": "cp migrations/*.sql dist/migrations",
+    "build:default-db": "cp default-db.sqlite dist/",
+    "build": "yarn run clean && yarn run build:app && yarn run build:node && yarn run build:migrations && yarn run build:default-db",
+    "test": "yarn run clean && yarn run build:app && yarn run build:crdt && vitest --run",
+    "clean": "rm -rf dist @types",
+    "typecheck": "yarn build && tsc --noEmit && tsc-strict"
   },
   "dependencies": {
-    "@actual-app/core": "workspace:*",
-    "@actual-app/crdt": "workspace:*",
+    "@actual-app/crdt": "workspace:^",
     "better-sqlite3": "^12.6.2",
     "compare-versions": "^6.1.1",
     "node-fetch": "^3.3.2",
     "uuid": "^13.0.0"
   },
   "devDependencies": {
-    "@typescript/native-preview": "^7.0.0-dev.20260309.1",
-    "rollup-plugin-visualizer": "^6.0.5",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.9.3",
     "typescript-strict-plugin": "^2.4.4",
-    "vite": "^8.0.0",
-    "vite-plugin-dts": "^4.5.4",
-    "vite-plugin-peggy-loader": "^2.0.1",
-    "vitest": "^4.1.0"
+    "vitest": "^4.0.18"
   },
   "engines": {
     "node": ">=20"

packages/api/tsconfig.json

@@ -1,22 +1,21 @@
 {
   "extends": "../../tsconfig.json",
   "compilerOptions": {
-    "composite": true,
     // Using ES2021 because that's the newest version where
     // the latest Node 16.x release supports all of the features
     "target": "ES2021",
-    "module": "es2022",
-    "moduleResolution": "bundler",
+    "module": "CommonJS",
+    "moduleResolution": "node10",
     "noEmit": false,
     "declaration": true,
-    "declarationMap": true,
     "outDir": "dist",
     "rootDir": ".",
     "declarationDir": "@types",
-    "tsBuildInfoFile": "dist/.tsbuildinfo",
+    "paths": {
+      "loot-core/*": ["./@types/loot-core/src/*"]
+    },
     "plugins": [{ "name": "typescript-strict-plugin", "paths": ["."] }]
   },
-  "references": [{ "path": "../crdt" }, { "path": "../loot-core" }],
   "include": ["."],
-  "exclude": ["**/node_modules/*", "dist", "@types", "*.test.ts", "*.config.ts"]
+  "exclude": ["**/node_modules/*", "dist", "@types", "*.test.ts"]
 }

packages/api/typings.ts

@@ -1,2 +0,0 @@
-declare module 'hyperformula/i18n/languages/enUS';
-declare module '*.pegjs';

packages/api/utils.ts

@@ -1,4 +1,6 @@
-import { lib } from '@actual-app/core/server/main';
+// oxlint-disable-next-line typescript/ban-ts-comment
+// @ts-ignore: bundle not available until we build it
+import * as bundle from './app/bundle.api.js';
 
-export const amountToInteger = lib.amountToInteger;
-export const integerToAmount = lib.integerToAmount;
+export const amountToInteger = bundle.lib.amountToInteger;
+export const integerToAmount = bundle.lib.integerToAmount;

packages/api/vite.config.ts

@@ -1,93 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-
-import { visualizer } from 'rollup-plugin-visualizer';
-import { defineConfig } from 'vite';
-import dts from 'vite-plugin-dts';
-import peggyLoader from 'vite-plugin-peggy-loader';
-
-const lootCoreRoot = path.resolve(__dirname, '../loot-core');
-const distDir = path.resolve(__dirname, 'dist');
-const typesDir = path.resolve(__dirname, '@types');
-
-function cleanOutputDirs() {
-  return {
-    name: 'clean-output-dirs',
-    buildStart() {
-      if (fs.existsSync(distDir)) fs.rmSync(distDir, { recursive: true });
-      if (fs.existsSync(typesDir)) fs.rmSync(typesDir, { recursive: true });
-    },
-  };
-}
-
-function copyMigrationsAndDefaultDb() {
-  return {
-    name: 'copy-migrations-and-default-db',
-    closeBundle() {
-      const migrationsSrc = path.join(lootCoreRoot, 'migrations');
-      const defaultDbPath = path.join(lootCoreRoot, 'default-db.sqlite');
-
-      if (!fs.existsSync(migrationsSrc)) {
-        throw new Error(`migrations directory not found at ${migrationsSrc}`);
-      }
-      const migrationsStat = fs.statSync(migrationsSrc);
-      if (!migrationsStat.isDirectory()) {
-        throw new Error(`migrations path is not a directory: ${migrationsSrc}`);
-      }
-
-      const migrationsDest = path.join(distDir, 'migrations');
-      fs.mkdirSync(migrationsDest, { recursive: true });
-      for (const name of fs.readdirSync(migrationsSrc)) {
-        if (name.endsWith('.sql') || name.endsWith('.js')) {
-          fs.copyFileSync(
-            path.join(migrationsSrc, name),
-            path.join(migrationsDest, name),
-          );
-        }
-      }
-
-      if (!fs.existsSync(defaultDbPath)) {
-        throw new Error(`default-db.sqlite not found at ${defaultDbPath}`);
-      }
-      fs.copyFileSync(defaultDbPath, path.join(distDir, 'default-db.sqlite'));
-    },
-  };
-}
-
-export default defineConfig({
-  ssr: { noExternal: true, external: ['better-sqlite3'] },
-  build: {
-    ssr: true,
-    target: 'node20',
-    outDir: distDir,
-    emptyOutDir: true,
-    sourcemap: true,
-    lib: {
-      entry: path.resolve(__dirname, 'index.ts'),
-      formats: ['cjs'],
-      fileName: () => 'index.js',
-    },
-  },
-  plugins: [
-    cleanOutputDirs(),
-    peggyLoader(),
-    dts({
-      tsconfigPath: path.resolve(__dirname, 'tsconfig.json'),
-      outDir: path.resolve(__dirname, '@types'),
-      rollupTypes: true,
-    }),
-    copyMigrationsAndDefaultDb(),
-    visualizer({ template: 'raw-data', filename: 'app/stats.json' }),
-  ],
-  resolve: {
-    extensions: ['.api.ts', '.js', '.ts', '.tsx', '.json'],
-  },
-  test: {
-    globals: true,
-    onConsoleLog(log: string, type: 'stdout' | 'stderr'): boolean | void {
-      // print only console.error
-      return type === 'stderr';
-    },
-    maxWorkers: 2,
-  },
-});

packages/api/vitest.config.ts

@@ -0,0 +1,10 @@
+export default {
+  test: {
+    globals: true,
+    onConsoleLog(log: string, type: 'stdout' | 'stderr'): boolean | void {
+      // print only console.error
+      return type === 'stderr';
+    },
+    maxWorkers: 2,
+  },
+};

packages/ci-actions/.gitignore

@@ -1 +0,0 @@
-dist/*

packages/ci-actions/package.json

@@ -3,18 +3,9 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "tsx": "node --import=extensionless/register --experimental-strip-types",
-    "test": "vitest --run",
-    "typecheck": "tsgo -b"
+    "test": "vitest --run"
   },
   "devDependencies": {
-    "@typescript/native-preview": "^7.0.0-dev.20260309.1",
-    "extensionless": "^2.0.6",
-    "vitest": "^4.1.0"
-  },
-  "extensionless": {
-    "lookFor": [
-      "ts"
-    ]
+    "vitest": "^4.0.18"
   }
 }

packages/ci-actions/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": [],
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "skipLibCheck": true,
-    "strict": true,
-    "types": ["node"],
-    "outDir": "dist",
-    "rootDir": ".",
-    "composite": true
-  },
-  "include": ["src/**/*", "bin/**/*"],
-  "exclude": ["node_modules"]
-}

packages/cli/.gitignore

@@ -1,7 +0,0 @@
-dist
-coverage
-.actualrc.json
-.actualrc
-.actualrc.yaml
-.actualrc.yml
-actual.config.js

packages/cli/README.md

@@ -1,155 +0,0 @@
-# @actual-app/cli
-
-> **WARNING:** This CLI is experimental.
-
-Command-line interface for [Actual Budget](https://actualbudget.org). Query and modify your budget data from the terminal — accounts, transactions, categories, payees, rules, schedules, and more.
-
-> **Note:** This CLI connects to a running [Actual sync server](https://actualbudget.org/docs/install/). It does not operate on local budget files directly.
-
-## Installation
-
-```bash
-npm install -g @actual-app/cli
-```
-
-Requires Node.js >= 22.
-
-## Quick Start
-
-```bash
-# Set connection details
-export ACTUAL_SERVER_URL=http://localhost:5006
-export ACTUAL_PASSWORD=your-password
-export ACTUAL_SYNC_ID=your-sync-id   # Found in Settings → Advanced → Sync ID
-
-# List your accounts
-actual accounts list
-
-# Check a balance
-actual accounts balance <account-id>
-
-# View this month's budget
-actual budgets month 2026-03
-```
-
-## Configuration
-
-Configuration is resolved in this order (highest priority first):
-
-1. **CLI flags** (`--server-url`, `--password`, etc.)
-2. **Environment variables**
-3. **Config file** (via [cosmiconfig](https://github.com/cosmiconfig/cosmiconfig))
-4. **Defaults** (`dataDir` defaults to `~/.actual-cli/data`)
-
-### Environment Variables
-
-| Variable               | Description                                   |
-| ---------------------- | --------------------------------------------- |
-| `ACTUAL_SERVER_URL`    | URL of the Actual sync server (required)      |
-| `ACTUAL_PASSWORD`      | Server password (required unless using token) |
-| `ACTUAL_SESSION_TOKEN` | Session token (alternative to password)       |
-| `ACTUAL_SYNC_ID`       | Budget Sync ID (required for most commands)   |
-| `ACTUAL_DATA_DIR`      | Local directory for cached budget data        |
-
-### Config File
-
-Create an `.actualrc.json` (or `.actualrc`, `.actualrc.yaml`, `actual.config.js`):
-
-```json
-{
-  "serverUrl": "http://localhost:5006",
-  "password": "your-password",
-  "syncId": "1cfdbb80-6274-49bf-b0c2-737235a4c81f"
-}
-```
-
-**Security:** Do not store plaintext passwords in config files (e.g. `.actualrc.json`, `.actualrc`, `.actualrc.yaml`, `actual.config.js`). Add these files to `.gitignore` if they contain secrets. Prefer the `ACTUAL_SESSION_TOKEN` environment variable instead of the `password` field. See [Environment Variables](#environment-variables) for using a session token.
-
-### Global Flags
-
-| Flag                      | Description                                     |
-| ------------------------- | ----------------------------------------------- |
-| `--server-url <url>`      | Server URL                                      |
-| `--password <pw>`         | Server password                                 |
-| `--session-token <token>` | Session token                                   |
-| `--sync-id <id>`          | Budget Sync ID                                  |
-| `--data-dir <path>`       | Data directory                                  |
-| `--format <format>`       | Output format: `json` (default), `table`, `csv` |
-| `--verbose`               | Show informational messages                     |
-
-## Commands
-
-| Command           | Description                    |
-| ----------------- | ------------------------------ |
-| `accounts`        | Manage accounts                |
-| `budgets`         | Manage budgets and allocations |
-| `categories`      | Manage categories              |
-| `category-groups` | Manage category groups         |
-| `transactions`    | Manage transactions            |
-| `payees`          | Manage payees                  |
-| `tags`            | Manage tags                    |
-| `rules`           | Manage transaction rules       |
-| `schedules`       | Manage scheduled transactions  |
-| `query`           | Run an ActualQL query          |
-| `server`          | Server utilities and lookups   |
-
-Run `actual <command> --help` for subcommands and options.
-
-### Examples
-
-```bash
-# List all accounts (as a table)
-actual accounts list --format table
-
-# Find an entity ID by name
-actual server get-id --type accounts --name "Checking"
-
-# Add a transaction (amount in integer cents: -2500 = -$25.00)
-actual transactions add --account <id> \
-  --data '[{"date":"2026-03-14","amount":-2500,"payee_name":"Coffee Shop"}]'
-
-# Export transactions to CSV
-actual transactions list --account <id> \
-  --start 2026-01-01 --end 2026-12-31 --format csv > transactions.csv
-
-# Set budget amount ($500 = 50000 cents)
-actual budgets set-amount --month 2026-03 --category <id> --amount 50000
-
-# Run an ActualQL query
-actual query run --table transactions \
-  --select "date,amount,payee" --filter '{"amount":{"$lt":0}}' --limit 10
-```
-
-### Amount Convention
-
-All monetary amounts are **integer cents**:
-
-| CLI Value | Dollar Amount |
-| --------- | ------------- |
-| `5000`    | $50.00        |
-| `-12350`  | -$123.50      |
-
-## Running Locally (Development)
-
-If you're working on the CLI within the monorepo:
-
-```bash
-# 1. Build the CLI
-yarn build:cli
-
-# 2. Start a local sync server (in a separate terminal)
-yarn start:server-dev
-
-# 3. Open http://localhost:5006 in your browser, create a budget,
-#    then find the Sync ID in Settings → Advanced → Sync ID
-
-# 4. Run the CLI directly from the build output
-ACTUAL_SERVER_URL=http://localhost:5006 \
-ACTUAL_PASSWORD=your-password \
-ACTUAL_SYNC_ID=your-sync-id \
-node packages/cli/dist/cli.js accounts list
-
-# Or use a shorthand alias for convenience
-alias actual-dev="node $(pwd)/packages/cli/dist/cli.js"
-actual-dev budgets list
-```

packages/cli/package.json

@@ -1,35 +0,0 @@
-{
-  "name": "@actual-app/cli",
-  "version": "26.3.0",
-  "description": "CLI for Actual Budget",
-  "license": "MIT",
-  "bin": {
-    "actual": "./dist/cli.js",
-    "actual-cli": "./dist/cli.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "type": "module",
-  "scripts": {
-    "build": "vite build",
-    "test": "vitest --run",
-    "typecheck": "tsgo -b"
-  },
-  "dependencies": {
-    "@actual-app/api": "workspace:*",
-    "cli-table3": "^0.6.5",
-    "commander": "^13.0.0",
-    "cosmiconfig": "^9.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.19.10",
-    "@typescript/native-preview": "^7.0.0-dev.20260309.1",
-    "rollup-plugin-visualizer": "^6.0.5",
-    "vite": "^8.0.0",
-    "vitest": "^4.1.0"
-  },
-  "engines": {
-    "node": ">=22"
-  }
-}

packages/cli/src/commands/accounts.test.ts

@@ -1,259 +0,0 @@
-import * as api from '@actual-app/api';
-import { Command } from 'commander';
-
-import { printOutput } from '../output';
-
-import { registerAccountsCommand } from './accounts';
-
-vi.mock('@actual-app/api', () => ({
-  getAccounts: vi.fn().mockResolvedValue([]),
-  createAccount: vi.fn().mockResolvedValue('new-id'),
-  updateAccount: vi.fn().mockResolvedValue(undefined),
-  closeAccount: vi.fn().mockResolvedValue(undefined),
-  reopenAccount: vi.fn().mockResolvedValue(undefined),
-  deleteAccount: vi.fn().mockResolvedValue(undefined),
-  getAccountBalance: vi.fn().mockResolvedValue(10000),
-}));
-
-vi.mock('../connection', () => ({
-  withConnection: vi.fn((_opts, fn) => fn()),
-}));
-
-vi.mock('../output', () => ({
-  printOutput: vi.fn(),
-}));
-
-function createProgram(): Command {
-  const program = new Command();
-  program.option('--format <format>');
-  program.option('--server-url <url>');
-  program.option('--password <pw>');
-  program.option('--session-token <token>');
-  program.option('--sync-id <id>');
-  program.option('--data-dir <dir>');
-  program.option('--verbose');
-  program.exitOverride();
-  registerAccountsCommand(program);
-  return program;
-}
-
-async function run(args: string[]) {
-  const program = createProgram();
-  await program.parseAsync(['node', 'test', ...args]);
-}
-
-describe('accounts commands', () => {
-  let stderrSpy: ReturnType<typeof vi.spyOn>;
-  let stdoutSpy: ReturnType<typeof vi.spyOn>;
-
-  beforeEach(() => {
-    vi.clearAllMocks();
-    stderrSpy = vi
-      .spyOn(process.stderr, 'write')
-      .mockImplementation(() => true);
-    stdoutSpy = vi
-      .spyOn(process.stdout, 'write')
-      .mockImplementation(() => true);
-  });
-
-  afterEach(() => {
-    stderrSpy.mockRestore();
-    stdoutSpy.mockRestore();
-  });
-
-  describe('list', () => {
-    it('calls api.getAccounts and prints result', async () => {
-      const accounts = [{ id: '1', name: 'Checking' }];
-      vi.mocked(api.getAccounts).mockResolvedValue(accounts);
-
-      await run(['accounts', 'list']);
-
-      expect(api.getAccounts).toHaveBeenCalled();
-      expect(printOutput).toHaveBeenCalledWith(accounts, undefined);
-    });
-
-    it('passes format option to printOutput', async () => {
-      vi.mocked(api.getAccounts).mockResolvedValue([]);
-
-      await run(['--format', 'csv', 'accounts', 'list']);
-
-      expect(printOutput).toHaveBeenCalledWith([], 'csv');
-    });
-  });
-
-  describe('create', () => {
-    it('passes name and defaults to api.createAccount', async () => {
-      await run(['accounts', 'create', '--name', 'Savings']);
-
-      expect(api.createAccount).toHaveBeenCalledWith(
-        { name: 'Savings', offbudget: false },
-        0,
-      );
-      expect(printOutput).toHaveBeenCalledWith({ id: 'new-id' }, undefined);
-    });
-
-    it('passes offbudget and balance options', async () => {
-      await run([
-        'accounts',
-        'create',
-        '--name',
-        'Investments',
-        '--offbudget',
-        '--balance',
-        '50000',
-      ]);
-
-      expect(api.createAccount).toHaveBeenCalledWith(
-        { name: 'Investments', offbudget: true },
-        50000,
-      );
-    });
-  });
-
-  describe('update', () => {
-    it('passes fields to api.updateAccount', async () => {
-      await run(['accounts', 'update', 'acct-1', '--name', 'NewName']);
-
-      expect(api.updateAccount).toHaveBeenCalledWith('acct-1', {
-        name: 'NewName',
-      });
-      expect(printOutput).toHaveBeenCalledWith(
-        { success: true, id: 'acct-1' },
-        undefined,
-      );
-    });
-
-    it('passes offbudget true', async () => {
-      await run([
-        'accounts',
-        'update',
-        'acct-1',
-        '--name',
-        'X',
-        '--offbudget',
-        'true',
-      ]);
-
-      expect(api.updateAccount).toHaveBeenCalledWith('acct-1', {
-        name: 'X',
-        offbudget: true,
-      });
-    });
-
-    it('passes offbudget false', async () => {
-      await run([
-        'accounts',
-        'update',
-        'acct-1',
-        '--name',
-        'X',
-        '--offbudget',
-        'false',
-      ]);
-
-      expect(api.updateAccount).toHaveBeenCalledWith('acct-1', {
-        name: 'X',
-        offbudget: false,
-      });
-    });
-
-    it('rejects invalid offbudget value', async () => {
-      await expect(
-        run(['accounts', 'update', 'acct-1', '--offbudget', 'yes']),
-      ).rejects.toThrow(
-        'Invalid --offbudget: "yes". Expected "true" or "false".',
-      );
-    });
-
-    it('rejects empty name', async () => {
-      await expect(
-        run(['accounts', 'update', 'acct-1', '--name', '  ']),
-      ).rejects.toThrow('Invalid --name: must be a non-empty string.');
-    });
-
-    it('rejects update with no fields', async () => {
-      await expect(run(['accounts', 'update', 'acct-1'])).rejects.toThrow(
-        'No update fields provided. Use --name or --offbudget.',
-      );
-    });
-  });
-
-  describe('close', () => {
-    it('passes transfer options to api.closeAccount', async () => {
-      await run([
-        'accounts',
-        'close',
-        'acct-1',
-        '--transfer-account',
-        'acct-2',
-      ]);
-
-      expect(api.closeAccount).toHaveBeenCalledWith(
-        'acct-1',
-        'acct-2',
-        undefined,
-      );
-    });
-
-    it('passes transfer category', async () => {
-      await run([
-        'accounts',
-        'close',
-        'acct-1',
-        '--transfer-category',
-        'cat-1',
-      ]);
-
-      expect(api.closeAccount).toHaveBeenCalledWith(
-        'acct-1',
-        undefined,
-        'cat-1',
-      );
-    });
-  });
-
-  describe('reopen', () => {
-    it('calls api.reopenAccount', async () => {
-      await run(['accounts', 'reopen', 'acct-1']);
-
-      expect(api.reopenAccount).toHaveBeenCalledWith('acct-1');
-      expect(printOutput).toHaveBeenCalledWith(
-        { success: true, id: 'acct-1' },
-        undefined,
-      );
-    });
-  });
-
-  describe('delete', () => {
-    it('calls api.deleteAccount', async () => {
-      await run(['accounts', 'delete', 'acct-1']);
-
-      expect(api.deleteAccount).toHaveBeenCalledWith('acct-1');
-      expect(printOutput).toHaveBeenCalledWith(
-        { success: true, id: 'acct-1' },
-        undefined,
-      );
-    });
-  });
-
-  describe('balance', () => {
-    it('calls api.getAccountBalance without cutoff', async () => {
-      await run(['accounts', 'balance', 'acct-1']);
-
-      expect(api.getAccountBalance).toHaveBeenCalledWith('acct-1', undefined);
-      expect(printOutput).toHaveBeenCalledWith(
-        { id: 'acct-1', balance: 10000 },
-        undefined,
-      );
-    });
-
-    it('calls api.getAccountBalance with cutoff date', async () => {
-      await run(['accounts', 'balance', 'acct-1', '--cutoff', '2025-01-15']);
-
-      expect(api.getAccountBalance).toHaveBeenCalledWith(
-        'acct-1',
-        new Date('2025-01-15'),
-      );
-    });
-  });
-});

packages/cli/src/commands/accounts.ts

@@ -1,135 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { printOutput } from '../output';
-import { parseBoolFlag, parseIntFlag } from '../utils';
-
-export function registerAccountsCommand(program: Command) {
-  const accounts = program.command('accounts').description('Manage accounts');
-
-  accounts
-    .command('list')
-    .description('List all accounts')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getAccounts();
-        printOutput(result, opts.format);
-      });
-    });
-
-  accounts
-    .command('create')
-    .description('Create a new account')
-    .requiredOption('--name <name>', 'Account name')
-    .option('--offbudget', 'Create as off-budget account', false)
-    .option('--balance <amount>', 'Initial balance in cents', '0')
-    .action(async cmdOpts => {
-      const balance = parseIntFlag(cmdOpts.balance, '--balance');
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const id = await api.createAccount(
-          { name: cmdOpts.name, offbudget: cmdOpts.offbudget },
-          balance,
-        );
-        printOutput({ id }, opts.format);
-      });
-    });
-
-  accounts
-    .command('update <id>')
-    .description('Update an account')
-    .option('--name <name>', 'New account name')
-    .option('--offbudget <bool>', 'Set off-budget status')
-    .action(async (id: string, cmdOpts) => {
-      const opts = program.opts();
-      const fields: Record<string, unknown> = {};
-      if (cmdOpts.name !== undefined) {
-        const trimmed = cmdOpts.name.trim();
-        if (trimmed === '') {
-          throw new Error('Invalid --name: must be a non-empty string.');
-        }
-        fields.name = trimmed;
-      }
-      if (cmdOpts.offbudget !== undefined) {
-        fields.offbudget = parseBoolFlag(cmdOpts.offbudget, '--offbudget');
-      }
-      if (Object.keys(fields).length === 0) {
-        throw new Error(
-          'No update fields provided. Use --name or --offbudget.',
-        );
-      }
-      await withConnection(opts, async () => {
-        await api.updateAccount(id, fields);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  accounts
-    .command('close <id>')
-    .description('Close an account')
-    .option(
-      '--transfer-account <id>',
-      'Transfer remaining balance to this account',
-    )
-    .option(
-      '--transfer-category <id>',
-      'Transfer remaining balance to this category',
-    )
-    .action(async (id: string, cmdOpts) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.closeAccount(
-          id,
-          cmdOpts.transferAccount,
-          cmdOpts.transferCategory,
-        );
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  accounts
-    .command('reopen <id>')
-    .description('Reopen a closed account')
-    .action(async (id: string) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.reopenAccount(id);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  accounts
-    .command('delete <id>')
-    .description('Delete an account')
-    .action(async (id: string) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.deleteAccount(id);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  accounts
-    .command('balance <id>')
-    .description('Get account balance')
-    .option('--cutoff <date>', 'Cutoff date (YYYY-MM-DD)')
-    .action(async (id: string, cmdOpts) => {
-      let cutoff: Date | undefined;
-      if (cmdOpts.cutoff) {
-        const cutoffDate = new Date(cmdOpts.cutoff);
-        if (Number.isNaN(cutoffDate.getTime())) {
-          throw new Error(
-            'Invalid cutoff date: expected a valid date (e.g. YYYY-MM-DD).',
-          );
-        }
-        cutoff = cutoffDate;
-      }
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const balance = await api.getAccountBalance(id, cutoff);
-        printOutput({ id, balance }, opts.format);
-      });
-    });
-}

packages/cli/src/commands/budgets.ts

@@ -1,135 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { resolveConfig } from '../config';
-import { withConnection } from '../connection';
-import { printOutput } from '../output';
-import { parseBoolFlag, parseIntFlag } from '../utils';
-
-export function registerBudgetsCommand(program: Command) {
-  const budgets = program.command('budgets').description('Manage budgets');
-
-  budgets
-    .command('list')
-    .description('List all available budgets')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(
-        opts,
-        async () => {
-          const result = await api.getBudgets();
-          printOutput(result, opts.format);
-        },
-        { loadBudget: false },
-      );
-    });
-
-  budgets
-    .command('download <syncId>')
-    .description('Download a budget by sync ID')
-    .option('--encryption-password <password>', 'Encryption password')
-    .action(async (syncId: string, cmdOpts) => {
-      const opts = program.opts();
-      const config = await resolveConfig(opts);
-      const password = config.encryptionPassword ?? cmdOpts.encryptionPassword;
-      await withConnection(
-        opts,
-        async () => {
-          await api.downloadBudget(syncId, {
-            password,
-          });
-          printOutput({ success: true, syncId }, opts.format);
-        },
-        { loadBudget: false },
-      );
-    });
-
-  budgets
-    .command('sync')
-    .description('Sync the current budget')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.sync();
-        printOutput({ success: true }, opts.format);
-      });
-    });
-
-  budgets
-    .command('months')
-    .description('List available budget months')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getBudgetMonths();
-        printOutput(result, opts.format);
-      });
-    });
-
-  budgets
-    .command('month <month>')
-    .description('Get budget data for a specific month (YYYY-MM)')
-    .action(async (month: string) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getBudgetMonth(month);
-        printOutput(result, opts.format);
-      });
-    });
-
-  budgets
-    .command('set-amount')
-    .description('Set budget amount for a category in a month')
-    .requiredOption('--month <month>', 'Budget month (YYYY-MM)')
-    .requiredOption('--category <id>', 'Category ID')
-    .requiredOption('--amount <amount>', 'Amount in cents')
-    .action(async cmdOpts => {
-      const amount = parseIntFlag(cmdOpts.amount, '--amount');
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.setBudgetAmount(cmdOpts.month, cmdOpts.category, amount);
-        printOutput({ success: true }, opts.format);
-      });
-    });
-
-  budgets
-    .command('set-carryover')
-    .description('Enable/disable carryover for a category')
-    .requiredOption('--month <month>', 'Budget month (YYYY-MM)')
-    .requiredOption('--category <id>', 'Category ID')
-    .requiredOption('--flag <bool>', 'Enable (true) or disable (false)')
-    .action(async cmdOpts => {
-      const flag = parseBoolFlag(cmdOpts.flag, '--flag');
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.setBudgetCarryover(cmdOpts.month, cmdOpts.category, flag);
-        printOutput({ success: true }, opts.format);
-      });
-    });
-
-  budgets
-    .command('hold-next-month')
-    .description('Hold budget amount for next month')
-    .requiredOption('--month <month>', 'Budget month (YYYY-MM)')
-    .requiredOption('--amount <amount>', 'Amount in cents')
-    .action(async cmdOpts => {
-      const parsedAmount = parseIntFlag(cmdOpts.amount, '--amount');
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.holdBudgetForNextMonth(cmdOpts.month, parsedAmount);
-        printOutput({ success: true }, opts.format);
-      });
-    });
-
-  budgets
-    .command('reset-hold')
-    .description('Reset budget hold for a month')
-    .requiredOption('--month <month>', 'Budget month (YYYY-MM)')
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.resetBudgetHold(cmdOpts.month);
-        printOutput({ success: true }, opts.format);
-      });
-    });
-}

packages/cli/src/commands/categories.ts

@@ -1,75 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { printOutput } from '../output';
-import { parseBoolFlag } from '../utils';
-
-export function registerCategoriesCommand(program: Command) {
-  const categories = program
-    .command('categories')
-    .description('Manage categories');
-
-  categories
-    .command('list')
-    .description('List all categories')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getCategories();
-        printOutput(result, opts.format);
-      });
-    });
-
-  categories
-    .command('create')
-    .description('Create a new category')
-    .requiredOption('--name <name>', 'Category name')
-    .requiredOption('--group-id <id>', 'Category group ID')
-    .option('--is-income', 'Mark as income category', false)
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const id = await api.createCategory({
-          name: cmdOpts.name,
-          group_id: cmdOpts.groupId,
-          is_income: cmdOpts.isIncome,
-          hidden: false,
-        });
-        printOutput({ id }, opts.format);
-      });
-    });
-
-  categories
-    .command('update <id>')
-    .description('Update a category')
-    .option('--name <name>', 'New category name')
-    .option('--hidden <bool>', 'Set hidden status')
-    .action(async (id: string, cmdOpts) => {
-      const fields: Record<string, unknown> = {};
-      if (cmdOpts.name !== undefined) fields.name = cmdOpts.name;
-      if (cmdOpts.hidden !== undefined) {
-        fields.hidden = parseBoolFlag(cmdOpts.hidden, '--hidden');
-      }
-      if (Object.keys(fields).length === 0) {
-        throw new Error('No update fields provided. Use --name or --hidden.');
-      }
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.updateCategory(id, fields);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  categories
-    .command('delete <id>')
-    .description('Delete a category')
-    .option('--transfer-to <id>', 'Transfer transactions to this category')
-    .action(async (id: string, cmdOpts) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.deleteCategory(id, cmdOpts.transferTo);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-}

packages/cli/src/commands/category-groups.ts

@@ -1,73 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { printOutput } from '../output';
-import { parseBoolFlag } from '../utils';
-
-export function registerCategoryGroupsCommand(program: Command) {
-  const groups = program
-    .command('category-groups')
-    .description('Manage category groups');
-
-  groups
-    .command('list')
-    .description('List all category groups')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getCategoryGroups();
-        printOutput(result, opts.format);
-      });
-    });
-
-  groups
-    .command('create')
-    .description('Create a new category group')
-    .requiredOption('--name <name>', 'Group name')
-    .option('--is-income', 'Mark as income group', false)
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const id = await api.createCategoryGroup({
-          name: cmdOpts.name,
-          is_income: cmdOpts.isIncome,
-          hidden: false,
-        });
-        printOutput({ id }, opts.format);
-      });
-    });
-
-  groups
-    .command('update <id>')
-    .description('Update a category group')
-    .option('--name <name>', 'New group name')
-    .option('--hidden <bool>', 'Set hidden status')
-    .action(async (id: string, cmdOpts) => {
-      const fields: Record<string, unknown> = {};
-      if (cmdOpts.name !== undefined) fields.name = cmdOpts.name;
-      if (cmdOpts.hidden !== undefined) {
-        fields.hidden = parseBoolFlag(cmdOpts.hidden, '--hidden');
-      }
-      if (Object.keys(fields).length === 0) {
-        throw new Error('No update fields provided. Use --name or --hidden.');
-      }
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.updateCategoryGroup(id, fields);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  groups
-    .command('delete <id>')
-    .description('Delete a category group')
-    .option('--transfer-to <id>', 'Transfer transactions to this category ID')
-    .action(async (id: string, cmdOpts) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.deleteCategoryGroup(id, cmdOpts.transferTo);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-}

packages/cli/src/commands/payees.ts

@@ -1,95 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { printOutput } from '../output';
-
-export function registerPayeesCommand(program: Command) {
-  const payees = program.command('payees').description('Manage payees');
-
-  payees
-    .command('list')
-    .description('List all payees')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getPayees();
-        printOutput(result, opts.format);
-      });
-    });
-
-  payees
-    .command('common')
-    .description('List frequently used payees')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getCommonPayees();
-        printOutput(result, opts.format);
-      });
-    });
-
-  payees
-    .command('create')
-    .description('Create a new payee')
-    .requiredOption('--name <name>', 'Payee name')
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const id = await api.createPayee({ name: cmdOpts.name });
-        printOutput({ id }, opts.format);
-      });
-    });
-
-  payees
-    .command('update <id>')
-    .description('Update a payee')
-    .option('--name <name>', 'New payee name')
-    .action(async (id: string, cmdOpts) => {
-      const fields: Record<string, unknown> = {};
-      if (cmdOpts.name) fields.name = cmdOpts.name;
-      if (Object.keys(fields).length === 0) {
-        throw new Error(
-          'No fields to update. Use --name to specify a new name.',
-        );
-      }
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.updatePayee(id, fields);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  payees
-    .command('delete <id>')
-    .description('Delete a payee')
-    .action(async (id: string) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.deletePayee(id);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  payees
-    .command('merge')
-    .description('Merge payees into a target payee')
-    .requiredOption('--target <id>', 'Target payee ID')
-    .requiredOption('--ids <ids>', 'Comma-separated payee IDs to merge')
-    .action(async (cmdOpts: { target: string; ids: string }) => {
-      const mergeIds = cmdOpts.ids
-        .split(',')
-        .map(id => id.trim())
-        .filter(id => id.length > 0);
-      if (mergeIds.length === 0) {
-        throw new Error(
-          'No valid payee IDs provided in --ids. Provide comma-separated IDs.',
-        );
-      }
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.mergePayees(cmdOpts.target, mergeIds);
-        printOutput({ success: true }, opts.format);
-      });
-    });
-}

packages/cli/src/commands/query.ts

@@ -1,93 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { readJsonInput } from '../input';
-import { printOutput } from '../output';
-import { parseIntFlag } from '../utils';
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function buildQueryFromFile(
-  parsed: Record<string, unknown>,
-  fallbackTable: string | undefined,
-) {
-  const table = typeof parsed.table === 'string' ? parsed.table : fallbackTable;
-  if (!table) {
-    throw new Error(
-      '--table is required when the input file lacks a "table" field',
-    );
-  }
-  let queryObj = api.q(table);
-  if (Array.isArray(parsed.select)) queryObj = queryObj.select(parsed.select);
-  if (isRecord(parsed.filter)) queryObj = queryObj.filter(parsed.filter);
-  if (Array.isArray(parsed.orderBy)) {
-    queryObj = queryObj.orderBy(parsed.orderBy);
-  }
-  if (typeof parsed.limit === 'number') queryObj = queryObj.limit(parsed.limit);
-  return queryObj;
-}
-
-function buildQueryFromFlags(cmdOpts: Record<string, string | undefined>) {
-  if (!cmdOpts.table) {
-    throw new Error('--table is required (or use --file)');
-  }
-  let queryObj = api.q(cmdOpts.table);
-
-  if (cmdOpts.select) {
-    queryObj = queryObj.select(cmdOpts.select.split(','));
-  }
-
-  if (cmdOpts.filter) {
-    queryObj = queryObj.filter(JSON.parse(cmdOpts.filter));
-  }
-
-  if (cmdOpts.orderBy) {
-    queryObj = queryObj.orderBy(cmdOpts.orderBy.split(','));
-  }
-
-  if (cmdOpts.limit) {
-    queryObj = queryObj.limit(parseIntFlag(cmdOpts.limit, '--limit'));
-  }
-
-  return queryObj;
-}
-
-export function registerQueryCommand(program: Command) {
-  const query = program
-    .command('query')
-    .description('Run AQL (Actual Query Language) queries');
-
-  query
-    .command('run')
-    .description('Execute an AQL query')
-    .option(
-      '--table <table>',
-      'Table to query (transactions, accounts, categories, payees)',
-    )
-    .option('--select <fields>', 'Comma-separated fields to select')
-    .option('--filter <json>', 'Filter expression as JSON')
-    .option('--order-by <fields>', 'Comma-separated fields to order by')
-    .option('--limit <n>', 'Limit number of results')
-    .option(
-      '--file <path>',
-      'Read full query object from JSON file (use - for stdin)',
-    )
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const parsed = cmdOpts.file ? readJsonInput(cmdOpts) : undefined;
-        if (parsed !== undefined && !isRecord(parsed)) {
-          throw new Error('Query file must contain a JSON object');
-        }
-        const queryObj = parsed
-          ? buildQueryFromFile(parsed, cmdOpts.table)
-          : buildQueryFromFlags(cmdOpts);
-
-        const result = await api.aqlQuery(queryObj);
-        printOutput(result, opts.format);
-      });
-    });
-}

packages/cli/src/commands/rules.ts

@@ -1,77 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { readJsonInput } from '../input';
-import { printOutput } from '../output';
-
-export function registerRulesCommand(program: Command) {
-  const rules = program
-    .command('rules')
-    .description('Manage transaction rules');
-
-  rules
-    .command('list')
-    .description('List all rules')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getRules();
-        printOutput(result, opts.format);
-      });
-    });
-
-  rules
-    .command('payee-rules <payeeId>')
-    .description('List rules for a specific payee')
-    .action(async (payeeId: string) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getPayeeRules(payeeId);
-        printOutput(result, opts.format);
-      });
-    });
-
-  rules
-    .command('create')
-    .description('Create a new rule')
-    .option('--data <json>', 'Rule definition as JSON')
-    .option('--file <path>', 'Read rule from JSON file (use - for stdin)')
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const rule = readJsonInput(cmdOpts) as Parameters<
-          typeof api.createRule
-        >[0];
-        const id = await api.createRule(rule);
-        printOutput({ id }, opts.format);
-      });
-    });
-
-  rules
-    .command('update')
-    .description('Update a rule')
-    .option('--data <json>', 'Rule data as JSON (must include id)')
-    .option('--file <path>', 'Read rule from JSON file (use - for stdin)')
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const rule = readJsonInput(cmdOpts) as Parameters<
-          typeof api.updateRule
-        >[0];
-        await api.updateRule(rule);
-        printOutput({ success: true }, opts.format);
-      });
-    });
-
-  rules
-    .command('delete <id>')
-    .description('Delete a rule')
-    .action(async (id: string) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.deleteRule(id);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-}

packages/cli/src/commands/schedules.ts

@@ -1,67 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { readJsonInput } from '../input';
-import { printOutput } from '../output';
-
-export function registerSchedulesCommand(program: Command) {
-  const schedules = program
-    .command('schedules')
-    .description('Manage scheduled transactions');
-
-  schedules
-    .command('list')
-    .description('List all schedules')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getSchedules();
-        printOutput(result, opts.format);
-      });
-    });
-
-  schedules
-    .command('create')
-    .description('Create a new schedule')
-    .option('--data <json>', 'Schedule definition as JSON')
-    .option('--file <path>', 'Read schedule from JSON file (use - for stdin)')
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const schedule = readJsonInput(cmdOpts) as Parameters<
-          typeof api.createSchedule
-        >[0];
-        const id = await api.createSchedule(schedule);
-        printOutput({ id }, opts.format);
-      });
-    });
-
-  schedules
-    .command('update <id>')
-    .description('Update a schedule')
-    .option('--data <json>', 'Fields to update as JSON')
-    .option('--file <path>', 'Read fields from JSON file (use - for stdin)')
-    .option('--reset-next-date', 'Reset next occurrence date', false)
-    .action(async (id: string, cmdOpts) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const fields = readJsonInput(cmdOpts) as Parameters<
-          typeof api.updateSchedule
-        >[1];
-        await api.updateSchedule(id, fields, cmdOpts.resetNextDate);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  schedules
-    .command('delete <id>')
-    .description('Delete a schedule')
-    .action(async (id: string) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.deleteSchedule(id);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-}

packages/cli/src/commands/server.ts

@@ -1,60 +0,0 @@
-import * as api from '@actual-app/api';
-import { Option } from 'commander';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { printOutput } from '../output';
-
-export function registerServerCommand(program: Command) {
-  const server = program.command('server').description('Server utilities');
-
-  server
-    .command('version')
-    .description('Get server version')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(
-        opts,
-        async () => {
-          const version = await api.getServerVersion();
-          printOutput({ version }, opts.format);
-        },
-        { loadBudget: false },
-      );
-    });
-
-  server
-    .command('get-id')
-    .description('Get entity ID by name')
-    .addOption(
-      new Option('--type <type>', 'Entity type')
-        .choices(['accounts', 'categories', 'payees', 'schedules'])
-        .makeOptionMandatory(),
-    )
-    .requiredOption('--name <name>', 'Entity name')
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const id = await api.getIDByName(cmdOpts.type, cmdOpts.name);
-        printOutput(
-          { id, type: cmdOpts.type, name: cmdOpts.name },
-          opts.format,
-        );
-      });
-    });
-
-  server
-    .command('bank-sync')
-    .description('Run bank synchronization')
-    .option('--account <id>', 'Specific account ID to sync')
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const args = cmdOpts.account
-          ? { accountId: cmdOpts.account }
-          : undefined;
-        await api.runBankSync(args);
-        printOutput({ success: true }, opts.format);
-      });
-    });
-}

packages/cli/src/commands/tags.ts

@@ -1,74 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { printOutput } from '../output';
-
-export function registerTagsCommand(program: Command) {
-  const tags = program.command('tags').description('Manage tags');
-
-  tags
-    .command('list')
-    .description('List all tags')
-    .action(async () => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getTags();
-        printOutput(result, opts.format);
-      });
-    });
-
-  tags
-    .command('create')
-    .description('Create a new tag')
-    .requiredOption('--tag <tag>', 'Tag name')
-    .option('--color <color>', 'Tag color')
-    .option('--description <description>', 'Tag description')
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const id = await api.createTag({
-          tag: cmdOpts.tag,
-          color: cmdOpts.color,
-          description: cmdOpts.description,
-        });
-        printOutput({ id }, opts.format);
-      });
-    });
-
-  tags
-    .command('update <id>')
-    .description('Update a tag')
-    .option('--tag <tag>', 'New tag name')
-    .option('--color <color>', 'New tag color')
-    .option('--description <description>', 'New tag description')
-    .action(async (id: string, cmdOpts) => {
-      const fields: Record<string, unknown> = {};
-      if (cmdOpts.tag !== undefined) fields.tag = cmdOpts.tag;
-      if (cmdOpts.color !== undefined) fields.color = cmdOpts.color;
-      if (cmdOpts.description !== undefined) {
-        fields.description = cmdOpts.description;
-      }
-      if (Object.keys(fields).length === 0) {
-        throw new Error(
-          'At least one of --tag, --color, or --description is required',
-        );
-      }
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.updateTag(id, fields);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  tags
-    .command('delete <id>')
-    .description('Delete a tag')
-    .action(async (id: string) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.deleteTag(id);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-}

packages/cli/src/commands/transactions.ts

@@ -1,114 +0,0 @@
-import * as api from '@actual-app/api';
-import type { Command } from 'commander';
-
-import { withConnection } from '../connection';
-import { readJsonInput } from '../input';
-import { printOutput } from '../output';
-
-export function registerTransactionsCommand(program: Command) {
-  const transactions = program
-    .command('transactions')
-    .description('Manage transactions');
-
-  transactions
-    .command('list')
-    .description('List transactions for an account')
-    .requiredOption('--account <id>', 'Account ID')
-    .requiredOption('--start <date>', 'Start date (YYYY-MM-DD)')
-    .requiredOption('--end <date>', 'End date (YYYY-MM-DD)')
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const result = await api.getTransactions(
-          cmdOpts.account,
-          cmdOpts.start,
-          cmdOpts.end,
-        );
-        printOutput(result, opts.format);
-      });
-    });
-
-  transactions
-    .command('add')
-    .description('Add transactions to an account')
-    .requiredOption('--account <id>', 'Account ID')
-    .option('--data <json>', 'Transaction data as JSON array')
-    .option(
-      '--file <path>',
-      'Read transaction data from JSON file (use - for stdin)',
-    )
-    .option('--learn-categories', 'Learn category assignments', false)
-    .option('--run-transfers', 'Process transfers', false)
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const transactions = readJsonInput(cmdOpts) as Parameters<
-          typeof api.addTransactions
-        >[1];
-        const result = await api.addTransactions(
-          cmdOpts.account,
-          transactions,
-          {
-            learnCategories: cmdOpts.learnCategories,
-            runTransfers: cmdOpts.runTransfers,
-          },
-        );
-        printOutput(result, opts.format);
-      });
-    });
-
-  transactions
-    .command('import')
-    .description('Import transactions to an account')
-    .requiredOption('--account <id>', 'Account ID')
-    .option('--data <json>', 'Transaction data as JSON array')
-    .option(
-      '--file <path>',
-      'Read transaction data from JSON file (use - for stdin)',
-    )
-    .option('--dry-run', 'Preview without importing', false)
-    .action(async cmdOpts => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const transactions = readJsonInput(cmdOpts) as Parameters<
-          typeof api.importTransactions
-        >[1];
-        const result = await api.importTransactions(
-          cmdOpts.account,
-          transactions,
-          {
-            defaultCleared: true,
-            dryRun: cmdOpts.dryRun,
-          },
-        );
-        printOutput(result, opts.format);
-      });
-    });
-
-  transactions
-    .command('update <id>')
-    .description('Update a transaction')
-    .option('--data <json>', 'Fields to update as JSON')
-    .option('--file <path>', 'Read fields from JSON file (use - for stdin)')
-    .action(async (id: string, cmdOpts) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        const fields = readJsonInput(cmdOpts) as Parameters<
-          typeof api.updateTransaction
-        >[1];
-        await api.updateTransaction(id, fields);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-
-  transactions
-    .command('delete <id>')
-    .description('Delete a transaction')
-    .action(async (id: string) => {
-      const opts = program.opts();
-      await withConnection(opts, async () => {
-        await api.deleteTransaction(id);
-        printOutput({ success: true, id }, opts.format);
-      });
-    });
-}

packages/cli/src/config.test.ts

@@ -1,176 +0,0 @@
-import { homedir } from 'os';
-import { join } from 'path';
-
-import { resolveConfig } from './config';
-
-const mockSearch = vi.fn().mockResolvedValue(null);
-
-vi.mock('cosmiconfig', () => ({
-  cosmiconfig: () => ({
-    search: (...args: unknown[]) => mockSearch(...args),
-  }),
-}));
-
-function mockConfigFile(config: Record<string, unknown> | null) {
-  if (config) {
-    mockSearch.mockResolvedValue({ config, isEmpty: false });
-  } else {
-    mockSearch.mockResolvedValue(null);
-  }
-}
-
-describe('resolveConfig', () => {
-  const savedEnv: Record<string, string | undefined> = {};
-  const envKeys = [
-    'ACTUAL_SERVER_URL',
-    'ACTUAL_PASSWORD',
-    'ACTUAL_SESSION_TOKEN',
-    'ACTUAL_SYNC_ID',
-    'ACTUAL_DATA_DIR',
-    'ACTUAL_ENCRYPTION_PASSWORD',
-  ];
-
-  beforeEach(() => {
-    for (const key of envKeys) {
-      savedEnv[key] = process.env[key];
-      delete process.env[key];
-    }
-    mockConfigFile(null);
-  });
-
-  afterEach(() => {
-    for (const key of envKeys) {
-      if (savedEnv[key] !== undefined) {
-        process.env[key] = savedEnv[key];
-      } else {
-        delete process.env[key];
-      }
-    }
-  });
-
-  describe('priority chain', () => {
-    it('CLI opts take highest priority', async () => {
-      process.env.ACTUAL_SERVER_URL = 'http://env';
-      process.env.ACTUAL_PASSWORD = 'envpw';
-      mockConfigFile({
-        serverUrl: 'http://file',
-        password: 'filepw',
-      });
-
-      const config = await resolveConfig({
-        serverUrl: 'http://cli',
-        password: 'clipw',
-      });
-
-      expect(config.serverUrl).toBe('http://cli');
-      expect(config.password).toBe('clipw');
-    });
-
-    it('env vars override file config', async () => {
-      process.env.ACTUAL_SERVER_URL = 'http://env';
-      process.env.ACTUAL_PASSWORD = 'envpw';
-      mockConfigFile({
-        serverUrl: 'http://file',
-        password: 'filepw',
-      });
-
-      const config = await resolveConfig({});
-
-      expect(config.serverUrl).toBe('http://env');
-      expect(config.password).toBe('envpw');
-    });
-
-    it('file config is used when no CLI opts or env vars', async () => {
-      mockConfigFile({
-        serverUrl: 'http://file',
-        password: 'filepw',
-        syncId: 'budget-1',
-      });
-
-      const config = await resolveConfig({});
-
-      expect(config.serverUrl).toBe('http://file');
-      expect(config.password).toBe('filepw');
-      expect(config.syncId).toBe('budget-1');
-    });
-  });
-
-  describe('defaults', () => {
-    it('dataDir defaults to ~/.actual-cli/data', async () => {
-      const config = await resolveConfig({
-        serverUrl: 'http://test',
-        password: 'pw',
-      });
-
-      expect(config.dataDir).toBe(join(homedir(), '.actual-cli', 'data'));
-    });
-
-    it('CLI opt overrides default dataDir', async () => {
-      const config = await resolveConfig({
-        serverUrl: 'http://test',
-        password: 'pw',
-        dataDir: '/custom/dir',
-      });
-
-      expect(config.dataDir).toBe('/custom/dir');
-    });
-  });
-
-  describe('validation', () => {
-    it('throws when serverUrl is missing', async () => {
-      await expect(resolveConfig({ password: 'pw' })).rejects.toThrow(
-        'Server URL is required',
-      );
-    });
-
-    it('throws when neither password nor sessionToken provided', async () => {
-      await expect(resolveConfig({ serverUrl: 'http://test' })).rejects.toThrow(
-        'Authentication required',
-      );
-    });
-
-    it('accepts sessionToken without password', async () => {
-      const config = await resolveConfig({
-        serverUrl: 'http://test',
-        sessionToken: 'tok',
-      });
-
-      expect(config.sessionToken).toBe('tok');
-      expect(config.password).toBeUndefined();
-    });
-
-    it('accepts password without sessionToken', async () => {
-      const config = await resolveConfig({
-        serverUrl: 'http://test',
-        password: 'pw',
-      });
-
-      expect(config.password).toBe('pw');
-      expect(config.sessionToken).toBeUndefined();
-    });
-  });
-
-  describe('cosmiconfig handling', () => {
-    it('handles null result (no config file found)', async () => {
-      mockConfigFile(null);
-
-      const config = await resolveConfig({
-        serverUrl: 'http://test',
-        password: 'pw',
-      });
-
-      expect(config.serverUrl).toBe('http://test');
-    });
-
-    it('handles isEmpty result', async () => {
-      mockSearch.mockResolvedValue({ config: {}, isEmpty: true });
-
-      const config = await resolveConfig({
-        serverUrl: 'http://test',
-        password: 'pw',
-      });
-
-      expect(config.serverUrl).toBe('http://test');
-    });
-  });
-});

packages/cli/src/config.ts

@@ -1,141 +0,0 @@
-import { homedir } from 'os';
-import { join } from 'path';
-
-import { cosmiconfig } from 'cosmiconfig';
-
-export type CliConfig = {
-  serverUrl: string;
-  password?: string;
-  sessionToken?: string;
-  syncId?: string;
-  dataDir: string;
-  encryptionPassword?: string;
-};
-
-export type CliGlobalOpts = {
-  serverUrl?: string;
-  password?: string;
-  sessionToken?: string;
-  syncId?: string;
-  dataDir?: string;
-  encryptionPassword?: string;
-  format?: 'json' | 'table' | 'csv';
-  verbose?: boolean;
-};
-
-type ConfigFileContent = {
-  serverUrl?: string;
-  password?: string;
-  sessionToken?: string;
-  syncId?: string;
-  dataDir?: string;
-  encryptionPassword?: string;
-};
-
-const configFileKeys: readonly string[] = [
-  'serverUrl',
-  'password',
-  'sessionToken',
-  'syncId',
-  'dataDir',
-  'encryptionPassword',
-];
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function validateConfigFileContent(value: unknown): ConfigFileContent {
-  if (!isRecord(value)) {
-    throw new Error(
-      'Invalid config file: expected an object with keys: ' +
-        configFileKeys.join(', '),
-    );
-  }
-  for (const key of Object.keys(value)) {
-    if (!configFileKeys.includes(key)) {
-      throw new Error(`Invalid config file: unknown key "${key}"`);
-    }
-    if (value[key] !== undefined && typeof value[key] !== 'string') {
-      throw new Error(
-        `Invalid config file: key "${key}" must be a string, got ${typeof value[key]}`,
-      );
-    }
-  }
-  return value as ConfigFileContent;
-}
-
-async function loadConfigFile(): Promise<ConfigFileContent> {
-  const explorer = cosmiconfig('actual', {
-    searchPlaces: [
-      'package.json',
-      '.actualrc',
-      '.actualrc.json',
-      '.actualrc.yaml',
-      '.actualrc.yml',
-      'actual.config.json',
-      'actual.config.yaml',
-      'actual.config.yml',
-    ],
-  });
-  const result = await explorer.search();
-  if (result && !result.isEmpty) {
-    return validateConfigFileContent(result.config);
-  }
-  return {};
-}
-
-export async function resolveConfig(
-  cliOpts: CliGlobalOpts,
-): Promise<CliConfig> {
-  const fileConfig = await loadConfigFile();
-
-  const serverUrl =
-    cliOpts.serverUrl ??
-    process.env.ACTUAL_SERVER_URL ??
-    fileConfig.serverUrl ??
-    '';
-
-  const password =
-    cliOpts.password ?? process.env.ACTUAL_PASSWORD ?? fileConfig.password;
-
-  const sessionToken =
-    cliOpts.sessionToken ??
-    process.env.ACTUAL_SESSION_TOKEN ??
-    fileConfig.sessionToken;
-
-  const syncId =
-    cliOpts.syncId ?? process.env.ACTUAL_SYNC_ID ?? fileConfig.syncId;
-
-  const dataDir =
-    cliOpts.dataDir ??
-    process.env.ACTUAL_DATA_DIR ??
-    fileConfig.dataDir ??
-    join(homedir(), '.actual-cli', 'data');
-
-  const encryptionPassword =
-    cliOpts.encryptionPassword ??
-    process.env.ACTUAL_ENCRYPTION_PASSWORD ??
-    fileConfig.encryptionPassword;
-
-  if (!serverUrl) {
-    throw new Error(
-      'Server URL is required. Set --server-url, ACTUAL_SERVER_URL env var, or serverUrl in config file.',
-    );
-  }
-
-  if (!password && !sessionToken) {
-    throw new Error(
-      'Authentication required. Set --password/--session-token, ACTUAL_PASSWORD/ACTUAL_SESSION_TOKEN env var, or password/sessionToken in config file.',
-    );
-  }
-
-  return {
-    serverUrl,
-    password,
-    sessionToken,
-    syncId,
-    dataDir,
-    encryptionPassword,
-  };
-}

packages/cli/src/connection.test.ts

@@ -1,134 +0,0 @@
-import * as api from '@actual-app/api';
-
-import { resolveConfig } from './config';
-import { withConnection } from './connection';
-
-vi.mock('@actual-app/api', () => ({
-  init: vi.fn().mockResolvedValue(undefined),
-  downloadBudget: vi.fn().mockResolvedValue(undefined),
-  shutdown: vi.fn().mockResolvedValue(undefined),
-}));
-
-vi.mock('./config', () => ({
-  resolveConfig: vi.fn(),
-}));
-
-function setConfig(overrides: Record<string, unknown> = {}) {
-  vi.mocked(resolveConfig).mockResolvedValue({
-    serverUrl: 'http://test',
-    password: 'pw',
-    dataDir: '/tmp/data',
-    syncId: 'budget-1',
-    ...overrides,
-  });
-}
-
-describe('withConnection', () => {
-  let stderrSpy: ReturnType<typeof vi.spyOn>;
-
-  beforeEach(() => {
-    vi.clearAllMocks();
-    stderrSpy = vi
-      .spyOn(process.stderr, 'write')
-      .mockImplementation(() => true);
-    setConfig();
-  });
-
-  afterEach(() => {
-    stderrSpy.mockRestore();
-  });
-
-  it('calls api.init with password when no sessionToken', async () => {
-    setConfig({ password: 'pw', sessionToken: undefined });
-
-    await withConnection({}, async () => 'ok');
-
-    expect(api.init).toHaveBeenCalledWith({
-      serverURL: 'http://test',
-      password: 'pw',
-      dataDir: '/tmp/data',
-      verbose: undefined,
-    });
-  });
-
-  it('calls api.init with sessionToken when present', async () => {
-    setConfig({ sessionToken: 'tok', password: undefined });
-
-    await withConnection({}, async () => 'ok');
-
-    expect(api.init).toHaveBeenCalledWith({
-      serverURL: 'http://test',
-      sessionToken: 'tok',
-      dataDir: '/tmp/data',
-      verbose: undefined,
-    });
-  });
-
-  it('calls api.downloadBudget when syncId is set', async () => {
-    setConfig({ syncId: 'budget-1' });
-
-    await withConnection({}, async () => 'ok');
-
-    expect(api.downloadBudget).toHaveBeenCalledWith('budget-1', {
-      password: undefined,
-    });
-  });
-
-  it('throws when loadBudget is true but syncId is not set', async () => {
-    setConfig({ syncId: undefined });
-
-    await expect(withConnection({}, async () => 'ok')).rejects.toThrow(
-      'Sync ID is required',
-    );
-  });
-
-  it('skips budget download when loadBudget is false and syncId is not set', async () => {
-    setConfig({ syncId: undefined });
-
-    await withConnection({}, async () => 'ok', { loadBudget: false });
-
-    expect(api.downloadBudget).not.toHaveBeenCalled();
-  });
-
-  it('does not call api.downloadBudget when loadBudget is false', async () => {
-    setConfig({ syncId: 'budget-1' });
-
-    await withConnection({}, async () => 'ok', { loadBudget: false });
-
-    expect(api.downloadBudget).not.toHaveBeenCalled();
-  });
-
-  it('returns callback result', async () => {
-    const result = await withConnection({}, async () => 42);
-    expect(result).toBe(42);
-  });
-
-  it('calls api.shutdown in finally block on success', async () => {
-    await withConnection({}, async () => 'ok');
-    expect(api.shutdown).toHaveBeenCalled();
-  });
-
-  it('calls api.shutdown in finally block on error', async () => {
-    await expect(
-      withConnection({}, async () => {
-        throw new Error('boom');
-      }),
-    ).rejects.toThrow('boom');
-
-    expect(api.shutdown).toHaveBeenCalled();
-  });
-
-  it('does not write to stderr by default', async () => {
-    await withConnection({}, async () => 'ok');
-
-    expect(stderrSpy).not.toHaveBeenCalled();
-  });
-
-  it('writes info to stderr when verbose', async () => {
-    await withConnection({ verbose: true }, async () => 'ok');
-
-    expect(stderrSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Connecting to'),
-    );
-  });
-});

packages/cli/src/connection.ts

@@ -1,65 +0,0 @@
-import { mkdirSync } from 'fs';
-
-import * as api from '@actual-app/api';
-
-import { resolveConfig } from './config';
-import type { CliGlobalOpts } from './config';
-
-function info(message: string, verbose?: boolean) {
-  if (verbose) {
-    process.stderr.write(message + '\n');
-  }
-}
-
-type ConnectionOptions = {
-  loadBudget?: boolean;
-};
-
-export async function withConnection<T>(
-  globalOpts: CliGlobalOpts,
-  fn: () => Promise<T>,
-  options: ConnectionOptions = {},
-): Promise<T> {
-  const { loadBudget = true } = options;
-  const config = await resolveConfig(globalOpts);
-
-  mkdirSync(config.dataDir, { recursive: true });
-
-  info(`Connecting to ${config.serverUrl}...`, globalOpts.verbose);
-
-  if (config.sessionToken) {
-    await api.init({
-      serverURL: config.serverUrl,
-      dataDir: config.dataDir,
-      sessionToken: config.sessionToken,
-      verbose: globalOpts.verbose,
-    });
-  } else if (config.password) {
-    await api.init({
-      serverURL: config.serverUrl,
-      dataDir: config.dataDir,
-      password: config.password,
-      verbose: globalOpts.verbose,
-    });
-  } else {
-    throw new Error(
-      'Authentication required. Provide --password or --session-token, or set ACTUAL_PASSWORD / ACTUAL_SESSION_TOKEN.',
-    );
-  }
-
-  try {
-    if (loadBudget && config.syncId) {
-      info(`Downloading budget ${config.syncId}...`, globalOpts.verbose);
-      await api.downloadBudget(config.syncId, {
-        password: config.encryptionPassword,
-      });
-    } else if (loadBudget && !config.syncId) {
-      throw new Error(
-        'Sync ID is required for this command. Set --sync-id or ACTUAL_SYNC_ID.',
-      );
-    }
-    return await fn();
-  } finally {
-    await api.shutdown();
-  }
-}

packages/cli/src/index.ts

@@ -1,70 +0,0 @@
-import { Command, Option } from 'commander';
-
-import { registerAccountsCommand } from './commands/accounts';
-import { registerBudgetsCommand } from './commands/budgets';
-import { registerCategoriesCommand } from './commands/categories';
-import { registerCategoryGroupsCommand } from './commands/category-groups';
-import { registerPayeesCommand } from './commands/payees';
-import { registerQueryCommand } from './commands/query';
-import { registerRulesCommand } from './commands/rules';
-import { registerSchedulesCommand } from './commands/schedules';
-import { registerServerCommand } from './commands/server';
-import { registerTagsCommand } from './commands/tags';
-import { registerTransactionsCommand } from './commands/transactions';
-
-declare const __CLI_VERSION__: string;
-
-const program = new Command();
-
-program
-  .name('actual')
-  .description('CLI for Actual Budget')
-  .version(__CLI_VERSION__)
-  .option('--server-url <url>', 'Actual server URL (env: ACTUAL_SERVER_URL)')
-  .option('--password <password>', 'Server password (env: ACTUAL_PASSWORD)')
-  .option(
-    '--session-token <token>',
-    'Session token (env: ACTUAL_SESSION_TOKEN)',
-  )
-  .option('--sync-id <id>', 'Budget sync ID (env: ACTUAL_SYNC_ID)')
-  .option('--data-dir <path>', 'Data directory (env: ACTUAL_DATA_DIR)')
-  .option(
-    '--encryption-password <password>',
-    'E2E encryption password (env: ACTUAL_ENCRYPTION_PASSWORD)',
-  )
-  .addOption(
-    new Option('--format <format>', 'Output format: json, table, csv')
-      .choices(['json', 'table', 'csv'] as const)
-      .default('json'),
-  )
-  .option('--verbose', 'Show informational messages', false);
-
-registerAccountsCommand(program);
-registerBudgetsCommand(program);
-registerCategoriesCommand(program);
-registerCategoryGroupsCommand(program);
-registerTransactionsCommand(program);
-registerPayeesCommand(program);
-registerTagsCommand(program);
-registerRulesCommand(program);
-registerSchedulesCommand(program);
-registerQueryCommand(program);
-registerServerCommand(program);
-
-function normalizeThrownMessage(err: unknown): string {
-  if (err instanceof Error) return err.message;
-  if (typeof err === 'object' && err !== null) {
-    try {
-      return JSON.stringify(err);
-    } catch {
-      return '<non-serializable error>';
-    }
-  }
-  return String(err);
-}
-
-program.parseAsync(process.argv).catch((err: unknown) => {
-  const message = normalizeThrownMessage(err);
-  process.stderr.write(`Error: ${message}\n`);
-  process.exitCode = 1;
-});

packages/cli/src/input.ts

@@ -1,21 +0,0 @@
-import { readFileSync } from 'fs';
-
-export function readJsonInput(cmdOpts: {
-  data?: string;
-  file?: string;
-}): unknown {
-  if (cmdOpts.data && cmdOpts.file) {
-    throw new Error('Cannot use both --data and --file');
-  }
-  if (cmdOpts.data) {
-    return JSON.parse(cmdOpts.data);
-  }
-  if (cmdOpts.file) {
-    const content =
-      cmdOpts.file === '-'
-        ? readFileSync(0, 'utf-8')
-        : readFileSync(cmdOpts.file, 'utf-8');
-    return JSON.parse(content);
-  }
-  throw new Error('Either --data or --file is required');
-}

packages/cli/src/output.test.ts

@@ -1,152 +0,0 @@
-import { formatOutput, printOutput } from './output';
-
-describe('formatOutput', () => {
-  describe('json (default)', () => {
-    it('pretty-prints with 2-space indent', () => {
-      const data = { a: 1, b: 'two' };
-      expect(formatOutput(data)).toBe(JSON.stringify(data, null, 2));
-    });
-
-    it('is the default format', () => {
-      expect(formatOutput({ x: 1 })).toBe(formatOutput({ x: 1 }, 'json'));
-    });
-
-    it('handles arrays', () => {
-      const data = [1, 2, 3];
-      expect(formatOutput(data, 'json')).toBe('[\n  1,\n  2,\n  3\n]');
-    });
-
-    it('handles null', () => {
-      expect(formatOutput(null, 'json')).toBe('null');
-    });
-  });
-
-  describe('table', () => {
-    it('renders an object as key-value table', () => {
-      const result = formatOutput({ name: 'Alice', age: 30 }, 'table');
-      expect(result).toContain('name');
-      expect(result).toContain('Alice');
-      expect(result).toContain('age');
-      expect(result).toContain('30');
-    });
-
-    it('renders an array of objects as columnar table', () => {
-      const data = [
-        { id: 1, name: 'a' },
-        { id: 2, name: 'b' },
-      ];
-      const result = formatOutput(data, 'table');
-      expect(result).toContain('id');
-      expect(result).toContain('name');
-      expect(result).toContain('1');
-      expect(result).toContain('a');
-      expect(result).toContain('2');
-      expect(result).toContain('b');
-    });
-
-    it('returns "(no results)" for empty array', () => {
-      expect(formatOutput([], 'table')).toBe('(no results)');
-    });
-
-    it('returns String(data) for scalar values', () => {
-      expect(formatOutput(42, 'table')).toBe('42');
-      expect(formatOutput('hello', 'table')).toBe('hello');
-      expect(formatOutput(true, 'table')).toBe('true');
-    });
-
-    it('handles null/undefined values in objects', () => {
-      const data = [{ a: null, b: undefined }];
-      const result = formatOutput(data, 'table');
-      expect(result).toContain('a');
-      expect(result).toContain('b');
-    });
-  });
-
-  describe('csv', () => {
-    it('renders array of objects as header + data rows', () => {
-      const data = [
-        { id: 1, name: 'Alice' },
-        { id: 2, name: 'Bob' },
-      ];
-      const result = formatOutput(data, 'csv');
-      const lines = result.split('\n');
-      expect(lines[0]).toBe('id,name');
-      expect(lines[1]).toBe('1,Alice');
-      expect(lines[2]).toBe('2,Bob');
-    });
-
-    it('renders single object as header + single row', () => {
-      const result = formatOutput({ x: 10, y: 20 }, 'csv');
-      const lines = result.split('\n');
-      expect(lines[0]).toBe('x,y');
-      expect(lines[1]).toBe('10,20');
-    });
-
-    it('returns empty string for empty array', () => {
-      expect(formatOutput([], 'csv')).toBe('');
-    });
-
-    it('returns String(data) for scalar values', () => {
-      expect(formatOutput(42, 'csv')).toBe('42');
-      expect(formatOutput('hello', 'csv')).toBe('hello');
-    });
-
-    it('escapes commas by quoting', () => {
-      const data = [{ val: 'a,b' }];
-      expect(formatOutput(data, 'csv')).toBe('val\n"a,b"');
-    });
-
-    it('escapes double quotes by doubling them', () => {
-      const data = [{ val: 'say "hi"' }];
-      expect(formatOutput(data, 'csv')).toBe('val\n"say ""hi"""');
-    });
-
-    it('escapes newlines by quoting', () => {
-      const data = [{ val: 'line1\nline2' }];
-      expect(formatOutput(data, 'csv')).toBe('val\n"line1\nline2"');
-    });
-
-    it('handles null/undefined values', () => {
-      const data = [{ a: null, b: undefined }];
-      const result = formatOutput(data, 'csv');
-      const lines = result.split('\n');
-      expect(lines[0]).toBe('a,b');
-    });
-  });
-});
-
-describe('printOutput', () => {
-  let writeSpy: ReturnType<typeof vi.spyOn>;
-
-  beforeEach(() => {
-    writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
-  });
-
-  afterEach(() => {
-    writeSpy.mockRestore();
-  });
-
-  it('writes formatted output followed by newline', () => {
-    printOutput({ a: 1 }, 'json');
-    expect(writeSpy).toHaveBeenCalledWith(
-      JSON.stringify({ a: 1 }, null, 2) + '\n',
-    );
-  });
-
-  it('defaults to json format', () => {
-    printOutput([1, 2]);
-    expect(writeSpy).toHaveBeenCalledWith(
-      JSON.stringify([1, 2], null, 2) + '\n',
-    );
-  });
-
-  it('supports table format', () => {
-    printOutput([], 'table');
-    expect(writeSpy).toHaveBeenCalledWith('(no results)\n');
-  });
-
-  it('supports csv format', () => {
-    printOutput([], 'csv');
-    expect(writeSpy).toHaveBeenCalledWith('\n');
-  });
-});

packages/cli/src/output.ts

@@ -1,82 +0,0 @@
-import Table from 'cli-table3';
-
-export type OutputFormat = 'json' | 'table' | 'csv';
-
-export function formatOutput(
-  data: unknown,
-  format: OutputFormat = 'json',
-): string {
-  switch (format) {
-    case 'json':
-      return JSON.stringify(data, null, 2);
-    case 'table':
-      return formatTable(data);
-    case 'csv':
-      return formatCsv(data);
-    default:
-      return JSON.stringify(data, null, 2);
-  }
-}
-
-function formatTable(data: unknown): string {
-  if (!Array.isArray(data)) {
-    if (data && typeof data === 'object') {
-      const table = new Table();
-      for (const [key, value] of Object.entries(data)) {
-        table.push({ [key]: String(value) });
-      }
-      return table.toString();
-    }
-    return String(data);
-  }
-
-  if (data.length === 0) {
-    return '(no results)';
-  }
-
-  const keys = Object.keys(data[0] as Record<string, unknown>);
-  const table = new Table({ head: keys });
-
-  for (const row of data) {
-    const r = row as Record<string, unknown>;
-    table.push(keys.map(k => String(r[k] ?? '')));
-  }
-
-  return table.toString();
-}
-
-function formatCsv(data: unknown): string {
-  if (!Array.isArray(data)) {
-    if (data && typeof data === 'object') {
-      const entries = Object.entries(data);
-      const header = entries.map(([k]) => escapeCsv(k)).join(',');
-      const values = entries.map(([, v]) => escapeCsv(String(v))).join(',');
-      return header + '\n' + values;
-    }
-    return String(data);
-  }
-
-  if (data.length === 0) {
-    return '';
-  }
-
-  const keys = Object.keys(data[0] as Record<string, unknown>);
-  const header = keys.map(k => escapeCsv(k)).join(',');
-  const rows = data.map(row => {
-    const r = row as Record<string, unknown>;
-    return keys.map(k => escapeCsv(String(r[k] ?? ''))).join(',');
-  });
-
-  return [header, ...rows].join('\n');
-}
-
-function escapeCsv(value: string): string {
-  if (value.includes(',') || value.includes('"') || value.includes('\n')) {
-    return '"' + value.replace(/"/g, '""') + '"';
-  }
-  return value;
-}
-
-export function printOutput(data: unknown, format: OutputFormat = 'json') {
-  process.stdout.write(formatOutput(data, format) + '\n');
-}

packages/cli/src/utils.test.ts

@@ -1,65 +0,0 @@
-import { parseBoolFlag, parseIntFlag } from './utils';
-
-describe('parseBoolFlag', () => {
-  it('parses "true"', () => {
-    expect(parseBoolFlag('true', '--flag')).toBe(true);
-  });
-
-  it('parses "false"', () => {
-    expect(parseBoolFlag('false', '--flag')).toBe(false);
-  });
-
-  it('rejects other strings', () => {
-    expect(() => parseBoolFlag('yes', '--flag')).toThrow(
-      'Invalid --flag: "yes". Expected "true" or "false".',
-    );
-  });
-
-  it('includes the flag name in the error message', () => {
-    expect(() => parseBoolFlag('1', '--offbudget')).toThrow(
-      'Invalid --offbudget',
-    );
-  });
-});
-
-describe('parseIntFlag', () => {
-  it('parses a valid integer string', () => {
-    expect(parseIntFlag('42', '--balance')).toBe(42);
-  });
-
-  it('parses zero', () => {
-    expect(parseIntFlag('0', '--balance')).toBe(0);
-  });
-
-  it('parses negative integers', () => {
-    expect(parseIntFlag('-10', '--balance')).toBe(-10);
-  });
-
-  it('rejects decimal values', () => {
-    expect(() => parseIntFlag('3.5', '--balance')).toThrow(
-      'Invalid --balance: "3.5". Expected an integer.',
-    );
-  });
-
-  it('rejects non-numeric strings', () => {
-    expect(() => parseIntFlag('abc', '--balance')).toThrow(
-      'Invalid --balance: "abc". Expected an integer.',
-    );
-  });
-
-  it('rejects partially numeric strings', () => {
-    expect(() => parseIntFlag('3abc', '--balance')).toThrow(
-      'Invalid --balance: "3abc". Expected an integer.',
-    );
-  });
-
-  it('rejects empty string', () => {
-    expect(() => parseIntFlag('', '--balance')).toThrow(
-      'Invalid --balance: "". Expected an integer.',
-    );
-  });
-
-  it('includes the flag name in the error message', () => {
-    expect(() => parseIntFlag('x', '--amount')).toThrow('Invalid --amount');
-  });
-});

packages/cli/src/utils.ts

@@ -1,16 +0,0 @@
-export function parseBoolFlag(value: string, flagName: string): boolean {
-  if (value !== 'true' && value !== 'false') {
-    throw new Error(
-      `Invalid ${flagName}: "${value}". Expected "true" or "false".`,
-    );
-  }
-  return value === 'true';
-}
-
-export function parseIntFlag(value: string, flagName: string): number {
-  const parsed = value.trim() === '' ? NaN : Number(value);
-  if (!Number.isInteger(parsed)) {
-    throw new Error(`Invalid ${flagName}: "${value}". Expected an integer.`);
-  }
-  return parsed;
-}

packages/cli/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "composite": true,
-    "lib": ["ES2021"],
-    "types": ["vitest/globals", "node"],
-    "noEmit": false,
-    "strict": true,
-    "outDir": "dist",
-    "tsBuildInfoFile": "dist/.tsbuildinfo"
-  },
-  "references": [{ "path": "../api" }],
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "coverage"]
-}

packages/cli/vite.config.ts

@@ -1,36 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-
-import { visualizer } from 'rollup-plugin-visualizer';
-import { defineConfig } from 'vite';
-
-const pkg = JSON.parse(
-  fs.readFileSync(path.resolve(__dirname, 'package.json'), 'utf-8'),
-);
-
-export default defineConfig({
-  define: {
-    __CLI_VERSION__: JSON.stringify(pkg.version),
-  },
-  ssr: { noExternal: true, external: ['@actual-app/api'] },
-  build: {
-    ssr: true,
-    target: 'node22',
-    outDir: path.resolve(__dirname, 'dist'),
-    emptyOutDir: true,
-    lib: {
-      entry: path.resolve(__dirname, 'src/index.ts'),
-      formats: ['es'],
-    },
-    rollupOptions: {
-      output: {
-        entryFileNames: 'cli.js',
-        banner: chunk => (chunk.isEntry ? '#!/usr/bin/env node' : ''),
-      },
-    },
-  },
-  plugins: [visualizer({ template: 'raw-data', filename: 'dist/stats.json' })],
-  test: {
-    globals: true,
-  },
-});

packages/component-library/.storybook/main.ts

@@ -2,7 +2,7 @@ import { dirname } from 'path';
 import { fileURLToPath } from 'url';
 
 import type { StorybookConfig } from '@storybook/react-vite';
-import react from '@vitejs/plugin-react';
+import viteTsconfigPaths from 'vite-tsconfig-paths';
 
 /**
  * This function is used to resolve the absolute path of a package.
@@ -32,9 +32,11 @@ const config: StorybookConfig = {
     const { mergeConfig } = await import('vite');
 
     return mergeConfig(config, {
-      plugins: [react()],
-      resolve: {
-        tsconfigPaths: true,
+      // Telling Vite how to resolve path aliases
+      plugins: [viteTsconfigPaths({ root: '../..' })],
+      esbuild: {
+        // Needed to handle JSX in .ts/.tsx files
+        jsx: 'automatic',
       },
     });
   },

packages/component-library/.storybook/preview.tsx

@@ -3,7 +3,6 @@ import { type ReactNode } from 'react';
 import type { Preview } from '@storybook/react-vite';
 
 // Not ideal to import from desktop-client, but we need a source of truth for theme variables
-// TODO: this needs refactoring
 import * as darkTheme from '../../desktop-client/src/style/themes/dark';
 import * as developmentTheme from '../../desktop-client/src/style/themes/development';
 import * as lightTheme from '../../desktop-client/src/style/themes/light';

packages/component-library/package.json

@@ -40,7 +40,7 @@
     "test:web": "ENV=web vitest --run -c vitest.web.config.ts",
     "start:storybook": "storybook dev -p 6006",
     "build:storybook": "storybook build",
-    "typecheck": "tsgo -b"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@emotion/css": "^11.13.5",
@@ -54,14 +54,11 @@
     "@storybook/react-vite": "^10.2.7",
     "@svgr/cli": "^8.1.0",
     "@types/react": "^19.2.5",
-    "@typescript/native-preview": "^7.0.0-dev.20260309.1",
-    "@vitejs/plugin-react": "^6.0.0",
     "eslint-plugin-storybook": "^10.2.7",
     "react": "19.2.4",
     "react-dom": "19.2.4",
     "storybook": "^10.2.7",
-    "vite": "^8.0.0",
-    "vitest": "^4.1.0"
+    "vitest": "^4.0.18"
   },
   "peerDependencies": {
     "react": ">=19.2",

packages/component-library/src/Menu.tsx

@@ -16,8 +16,8 @@ import { View } from './View';
 
 const MenuLine: unique symbol = Symbol('menu-line');
 const MenuLabel: unique symbol = Symbol('menu-label');
-Menu.line = MenuLine as typeof MenuLine;
-Menu.label = MenuLabel as typeof MenuLabel;
+Menu.line = MenuLine;
+Menu.label = MenuLabel;
 
 type KeybindingProps = {
   keyName: ReactNode;

packages/component-library/tsconfig.json

@@ -1,14 +1,9 @@
 {
   "extends": "../../tsconfig.json",
   "compilerOptions": {
-    "composite": true,
-    "noEmit": false,
-    "declaration": true,
-    "declarationMap": true,
+    "noEmit": true,
     "rootDir": "src",
-    "strict": true,
-    "outDir": "dist",
-    "tsBuildInfoFile": "dist/.tsbuildinfo"
+    "strict": true
   },
   "include": ["src/**/*.ts", "src/**/*.tsx"],
   "exclude": ["node_modules"]

packages/component-library/vitest.web.config.ts

@@ -1,6 +1,5 @@
 import path from 'path';
 
-import react from '@vitejs/plugin-react';
 import peggyLoader from 'vite-plugin-peggy-loader';
 import { defineConfig } from 'vitest/config';
 
@@ -24,7 +23,13 @@ export default defineConfig({
     maxWorkers: 2,
   },
   resolve: {
+    alias: [
+      {
+        find: /^@actual-app\/crdt(\/.*)?$/,
+        replacement: path.resolve('../../../crdt/src$1'),
+      },
+    ],
     extensions: resolveExtensions,
   },
-  plugins: [react(), peggyLoader()],
+  plugins: [peggyLoader()],
 });

packages/crdt/package.json

@@ -8,23 +8,12 @@
   ],
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "exports": {
-    ".": "./src/index.ts"
-  },
-  "publishConfig": {
-    "exports": {
-      ".": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
-    }
-  },
   "scripts": {
-    "build:node": "tsgo",
+    "build:node": "tsc",
     "proto:generate": "./bin/generate-proto",
     "build": "rm -rf dist && yarn run build:node",
     "test": "vitest --run",
-    "typecheck": "tsgo -b"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "google-protobuf": "^3.21.4",
@@ -33,9 +22,9 @@
   },
   "devDependencies": {
     "@types/google-protobuf": "3.15.12",
-    "@typescript/native-preview": "^7.0.0-dev.20260309.1",
     "protoc-gen-js": "3.21.4-4",
     "ts-protoc-gen": "0.15.0",
-    "vitest": "^4.1.0"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   }
 }

packages/crdt/src/crdt/merkle.ts

@@ -91,7 +91,7 @@ export function diff(trie1: TrieNode, trie2: TrieNode): number | null {
   while (true) {
     const keyset = new Set([...getKeys(node1), ...getKeys(node2)]);
     const keys = [...keyset.values()];
-    keys.sort((a, b) => a.localeCompare(b));
+    keys.sort();
 
     let diffkey: null | '0' | '1' | '2' = null;
 
@@ -145,7 +145,7 @@ export function prune(trie: TrieNode, n = 2): TrieNode {
   }
 
   const keys = getKeys(trie);
-  keys.sort((a, b) => a.localeCompare(b));
+  keys.sort();
 
   const next: TrieNode = { hash: trie.hash };
 

packages/crdt/src/crdt/timestamp.test.ts

@@ -121,12 +121,12 @@ describe('Timestamp', function () {
     it('should fail with counter overflow', function () {
       now = 40;
       for (let i = 0; i < 65536; i++) Timestamp.send();
-      expect(() => Timestamp.send()).toThrow(Timestamp.OverflowError);
+      expect(Timestamp.send).toThrow(Timestamp.OverflowError);
     });
 
     it('should fail with clock drift', function () {
       now = -(5 * 60 * 1000 + 1);
-      expect(() => Timestamp.send()).toThrow(Timestamp.ClockDriftError);
+      expect(Timestamp.send).toThrow(Timestamp.ClockDriftError);
     });
   });
 

packages/crdt/tsconfig.json

@@ -1,7 +1,6 @@
 {
   "extends": "../../tsconfig.json",
   "compilerOptions": {
-    "composite": true,
     // Using ES2021 because that's the newest version where
     // the latest Node 16.x release supports all of the features
     "target": "ES2021",
@@ -9,10 +8,8 @@
     "moduleResolution": "node10",
     "noEmit": false,
     "declaration": true,
-    "declarationMap": true,
     "strict": true,
-    "outDir": "dist",
-    "tsBuildInfoFile": "dist/.tsbuildinfo"
+    "outDir": "dist"
   },
   "include": ["."],
   "exclude": ["dist", "**/*.test.ts", "**/*.spec.ts"]

packages/desktop-client/e2e/page-models/configuration-page.ts

@@ -61,7 +61,7 @@ export class ConfigurationPage {
         break;
 
       default:
-        throw new Error(`Unrecognized import type: ${String(type)}`);
+        throw new Error(`Unrecognized import type: ${type}`);
     }
 
     const fileChooser = await fileChooserPromise;

packages/desktop-client/e2e/page-models/custom-report-page.ts

@@ -39,7 +39,7 @@ export class CustomReportPage {
           .click();
         break;
       default:
-        throw new Error(`Unrecognized mode: ${String(mode)}`);
+        throw new Error(`Unrecognized mode: ${mode}`);
     }
   }
 }

packages/desktop-client/e2e/page-models/mobile-payees-page.ts

@@ -1,18 +1,18 @@
 import type { Locator, Page } from '@playwright/test';
 
+const NO_PAYEES_FOUND_TEXT = 'No payees found.';
+
 export class MobilePayeesPage {
   readonly page: Page;
   readonly searchBox: Locator;
   readonly payeesList: Locator;
-  readonly emptyMessage: Locator;
-  readonly loadingIndicator: Locator;
+  readonly noPayeesFoundText: Locator;
 
   constructor(page: Page) {
     this.page = page;
     this.searchBox = page.getByPlaceholder('Filter payees…');
     this.payeesList = page.getByRole('grid', { name: 'Payees' });
-    this.emptyMessage = page.getByText('No payees found.');
-    this.loadingIndicator = page.getByTestId('animated-loading');
+    this.noPayeesFoundText = this.payeesList.getByText(NO_PAYEES_FOUND_TEXT);
   }
 
   async waitFor(options?: {
@@ -47,7 +47,11 @@ export class MobilePayeesPage {
    * Get all visible payee items
    */
   getAllPayees() {
-    return this.payeesList.getByRole('gridcell');
+    // `GridList.renderEmptyState` still renders a row with "No payees found" text
+    // when no payees are present, so we need to filter that out to get the actual payee items.
+    return this.payeesList
+      .getByRole('row')
+      .filter({ hasNotText: NO_PAYEES_FOUND_TEXT });
   }
 
   /**
@@ -65,11 +69,4 @@ export class MobilePayeesPage {
     const payees = this.getAllPayees();
     return await payees.count();
   }
-
-  /**
-   * Wait for loading to complete
-   */
-  async waitForLoadingToComplete(timeout: number = 10000) {
-    await this.loadingIndicator.waitFor({ state: 'hidden', timeout });
-  }
 }

packages/desktop-client/e2e/page-models/mobile-rules-page.ts

@@ -1,18 +1,21 @@
 import type { Locator, Page } from '@playwright/test';
 
+const NO_RULES_FOUND_TEXT =
+  'No rules found. Create your first rule to get started!';
+
 export class MobileRulesPage {
   readonly page: Page;
   readonly searchBox: Locator;
   readonly addButton: Locator;
   readonly rulesList: Locator;
-  readonly emptyMessage: Locator;
+  readonly noRulesFoundText: Locator;
 
   constructor(page: Page) {
     this.page = page;
     this.searchBox = page.getByPlaceholder('Filter rules…');
     this.addButton = page.getByRole('button', { name: 'Add new rule' });
-    this.rulesList = page.getByRole('main');
-    this.emptyMessage = page.getByText('No rules found');
+    this.rulesList = page.getByRole('grid', { name: 'Rules' });
+    this.noRulesFoundText = this.rulesList.getByText(NO_RULES_FOUND_TEXT);
   }
 
   async waitFor(options?: {
@@ -47,7 +50,11 @@ export class MobileRulesPage {
    * Get all visible rule items
    */
   getAllRules() {
-    return this.page.getByRole('grid', { name: 'Rules' }).getByRole('row');
+    // `GridList.renderEmptyState` still renders a row with "No rules found" text
+    // when no rules are present, so we need to filter that out to get the actual rule items.
+    return this.rulesList
+      .getByRole('row')
+      .filter({ hasNotText: NO_RULES_FOUND_TEXT });
   }
 
   /**

packages/desktop-client/e2e/page-models/mobile-schedules-page.ts

@@ -1,22 +1,23 @@
 import type { Locator, Page } from '@playwright/test';
 
+const NO_SCHEDULES_FOUND_TEXT =
+  'No schedules found. Create your first schedule to get started!';
+
 export class MobileSchedulesPage {
   readonly page: Page;
   readonly searchBox: Locator;
   readonly addButton: Locator;
   readonly schedulesList: Locator;
-  readonly emptyMessage: Locator;
-  readonly loadingIndicator: Locator;
+  readonly noSchedulesFoundText: Locator;
 
   constructor(page: Page) {
     this.page = page;
     this.searchBox = page.getByPlaceholder('Filter schedules…');
     this.addButton = page.getByRole('button', { name: 'Add new schedule' });
     this.schedulesList = page.getByRole('grid', { name: 'Schedules' });
-    this.emptyMessage = page.getByText(
-      'No schedules found. Create your first schedule to get started!',
+    this.noSchedulesFoundText = this.schedulesList.getByText(
+      NO_SCHEDULES_FOUND_TEXT,
     );
-    this.loadingIndicator = page.getByTestId('animated-loading');
   }
 
   async waitFor(options?: {
@@ -51,7 +52,11 @@ export class MobileSchedulesPage {
    * Get all visible schedule items
    */
   getAllSchedules() {
-    return this.schedulesList.getByRole('gridcell');
+    // `GridList.renderEmptyState` still renders a row with "No schedules found" text
+    // when no schedules are present, so we need to filter that out to get the actual schedule items.
+    return this.schedulesList
+      .getByRole('row')
+      .filter({ hasNotText: NO_SCHEDULES_FOUND_TEXT });
   }
 
   /**
@@ -76,11 +81,4 @@ export class MobileSchedulesPage {
     const schedules = this.getAllSchedules();
     return await schedules.count();
   }
-
-  /**
-   * Wait for loading to complete
-   */
-  async waitForLoadingToComplete(timeout: number = 10000) {
-    await this.loadingIndicator.waitFor({ state: 'hidden', timeout });
-  }
 }

packages/desktop-client/e2e/payees.mobile.test.ts

@@ -34,8 +34,6 @@ test.describe('Mobile Payees', () => {
   });
 
   test('checks the page visuals', async () => {
-    await payeesPage.waitForLoadingToComplete();
-
     // Check that the header is present
     await expect(page.getByRole('heading', { name: 'Payees' })).toBeVisible();
 
@@ -63,8 +61,6 @@ test.describe('Mobile Payees', () => {
   });
 
   test('clicking on a payee opens payee edit page', async () => {
-    await payeesPage.waitForLoadingToComplete();
-
     const payeeCount = await payeesPage.getPayeeCount();
     expect(payeeCount).toBeGreaterThan(0);
 
@@ -89,8 +85,7 @@ test.describe('Mobile Payees', () => {
     await page.waitForTimeout(500);
 
     // Check that empty message is shown
-    const emptyMessage = page.getByText('No payees found.');
-    await expect(emptyMessage).toBeVisible();
+    await expect(payeesPage.noPayeesFoundText).toBeVisible();
 
     // Check that no payee items are visible
     const payees = payeesPage.getAllPayees();
@@ -99,8 +94,6 @@ test.describe('Mobile Payees', () => {
   });
 
   test('search functionality works correctly', async () => {
-    await payeesPage.waitForLoadingToComplete();
-
     // Test searching for a specific payee
     await payeesPage.searchFor('Fast Internet');