[PR #8208] CLI: Search for config file in additional directories. #136448

Open
opened 2026-06-17 21:14:06 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/actualbudget/actual/pull/8208
Author: @thromer
Created: 6/13/2026
Status: 🔄 Open

Base: masterHead: cli-config


📝 Commits (8)

  • d69c111 CLI: Search for config file in additional directories.
  • a6fca4f Update CLI documention for config file location.
  • 5d4cb97 [autofix.ci] apply automated fixes
  • 2854e8f Address CodeRabbit comments.
  • cd58699 Fix typos.
  • 52c1d73 Mention option of trusting CA cert in CLI docs.
  • 853d623 Mention global config directory in release note
  • 6602e19 Merge branch 'master' into cli-config

📊 Changes

4 files changed (+43 additions, -6 deletions)

View changed files

📝 packages/cli/README.md (+18 -2)
📝 packages/cli/src/config.ts (+1 -0)
📝 packages/docs/docs/api/cli.md (+18 -4)
upcoming-release-notes/cli-config-dirs.md (+6 -0)

📄 Description

Description

Searches for config files in parent directories up to home directory and in the global config directory, so that the CLI works even if the config file is not located in the working directory. See changes to packages/cli/README.md#config-file for full directory and filename details. The implementation simply switches the cosmiconfig searchStrategy from the default none to global.

Also sync the config file documention in packages/cli/README.md and packages/docs/docs/api/cli.md.

Separate small CLI doc change: when connecting to a server with a self-signed cert, mention the option of trusting the CA's certificate.

None.

Testing

Manual testing with config file in ~/.config/actual/config.json.

Checklist

  • Release notes added (see link above)
  • No obvious regressions in affected areas
  • Self-review has been performed - I have read every line of this diff and can explain what each change does and why it is needed.

Bundle Stats

Bundle Files count Total bundle size % Changed
desktop-client 37 13.23 MB 0%
loot-core 1 4.86 MB 0%
api 2 3.87 MB 0%
cli 1 7.97 MB → 7.97 MB (+40 B) +0.00%
crdt 1 11.12 kB 0%
View detailed bundle stats

desktop-client

Total

Files count Total bundle size % Changed
37 13.23 MB 0%
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger
No assets were bigger

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
static/js/index.js 1.58 MB 0%
static/js/BackgroundImage.js 121.09 kB 0%
static/js/FormulaEditor.js 814.39 kB 0%
static/js/ManageRules.js 46.47 kB 0%
static/js/PayeeRuleCountLabel.js 7.1 kB 0%
static/js/ReportRouter.js 1.25 MB 0%
static/js/ScheduleEditForm.js 146.51 kB 0%
static/js/SchedulesTable.js 203.52 kB 0%
static/js/TransactionEdit.js 90.63 kB 0%
static/js/TransactionList.js 82.8 kB 0%
static/js/Value.js 4.49 MB 0%
static/js/_baseIsEqual.js 76.76 kB 0%
static/js/ca.js 185.63 kB 0%
static/js/client.js 450.92 kB 0%
static/js/da.js 100.19 kB 0%
static/js/de.js 182.38 kB 0%
static/js/en-GB.js 9.25 kB 0%
static/js/en.js 202.14 kB 0%
static/js/es.js 177.58 kB 0%
static/js/extends.js 473.99 kB 0%
static/js/fr.js 177.35 kB 0%
static/js/indexeddb-main-thread-worker-e59fee74.js 13.46 kB 0%
static/js/it.js 163.93 kB 0%
static/js/narrow.js 364.55 kB 0%
static/js/nb-NO.js 147.07 kB 0%
static/js/nl.js 119.71 kB 0%
static/js/pt-BR.js 187.34 kB 0%
static/js/resize-observer.js 18.06 kB 0%
static/js/th.js 173.33 kB 0%
static/js/theme.js 31.01 kB 0%
static/js/toString.js 638.95 kB 0%
static/js/uk.js 216.7 kB 0%
static/js/useFormatList.js 2.52 kB 0%
static/js/useTransactionBatchActions.js 9.71 kB 0%
static/js/wide.js 298.23 kB 0%
static/js/workbox-window.prod.es5.js 7.33 kB 0%
static/js/zh-Hans.js 116.44 kB 0%

loot-core

Total

Files count Total bundle size % Changed
1 4.86 MB 0%
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger
No assets were bigger

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
kcab.worker.DhLbg59B.js 4.86 MB 0%

api

Total

Files count Total bundle size % Changed
2 3.87 MB 0%
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger
No assets were bigger

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
index.js 3.87 MB 0%
models.js 0 B 0%

cli

Total

Files count Total bundle size % Changed
1 7.97 MB → 7.97 MB (+40 B) +0.00%
Changeset
File Δ Size
src/config.ts 📈 +40 B (+1.11%) 3.52 kB → 3.56 kB
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger

Asset File Size % Changed
cli.js 7.97 MB → 7.97 MB (+40 B) +0.00%

Smaller
No assets were smaller

Unchanged
No assets were unchanged


crdt

Total

Files count Total bundle size % Changed
1 11.12 kB 0%
View detailed bundle breakdown

Added
No assets were added

Removed
No assets were removed

Bigger
No assets were bigger

Smaller
No assets were smaller

Unchanged

Asset File Size % Changed
index.js 11.12 kB 0%

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/actualbudget/actual/pull/8208 **Author:** [@thromer](https://github.com/thromer) **Created:** 6/13/2026 **Status:** 🔄 Open **Base:** `master` ← **Head:** `cli-config` --- ### 📝 Commits (8) - [`d69c111`](https://github.com/actualbudget/actual/commit/d69c1118808210b1f76e0e7cf0eb70763f404c6b) CLI: Search for config file in additional directories. - [`a6fca4f`](https://github.com/actualbudget/actual/commit/a6fca4f2683f433e01e6b1576f06189a88ece457) Update CLI documention for config file location. - [`5d4cb97`](https://github.com/actualbudget/actual/commit/5d4cb9719dd84e0c9a5bb187d750833ca584d9a3) [autofix.ci] apply automated fixes - [`2854e8f`](https://github.com/actualbudget/actual/commit/2854e8f74e915c96f406eaf8d75e228c88160176) Address CodeRabbit comments. - [`cd58699`](https://github.com/actualbudget/actual/commit/cd58699ff6e5c50d36516540ff67bf350cdc9515) Fix typos. - [`52c1d73`](https://github.com/actualbudget/actual/commit/52c1d73589550dc31afa769343108ba29db19128) Mention option of trusting CA cert in CLI docs. - [`853d623`](https://github.com/actualbudget/actual/commit/853d6236ffeda2da6f046e14e2f817bc9388a519) Mention global config directory in release note - [`6602e19`](https://github.com/actualbudget/actual/commit/6602e19afe34117aa28075bec869d97306c071b6) Merge branch 'master' into cli-config ### 📊 Changes **4 files changed** (+43 additions, -6 deletions) <details> <summary>View changed files</summary> 📝 `packages/cli/README.md` (+18 -2) 📝 `packages/cli/src/config.ts` (+1 -0) 📝 `packages/docs/docs/api/cli.md` (+18 -4) ➕ `upcoming-release-notes/cli-config-dirs.md` (+6 -0) </details> ### 📄 Description ## Description Searches for config files in parent directories up to home directory and in the global config directory, so that the CLI works even if the config file is not located in the working directory. See changes to `packages/cli/README.md#config-file` for full directory and filename details. The implementation simply switches the [`cosmiconfig searchStrategy`](https://github.com/cosmiconfig/cosmiconfig#searchstrategy) from the default `none` to `global`. Also sync the config file documention in packages/cli/README.md and packages/docs/docs/api/cli.md. Separate small CLI doc change: when connecting to a server with a self-signed cert, mention the option of trusting the CA's certificate. ## Related issue(s) None. ## Testing Manual testing with config file in ~/.config/actual/config.json. ## Checklist - [x] Release notes added (see link above) - [x] No obvious regressions in affected areas - [x] Self-review has been performed - I have read every line of this diff and can explain what each change does and why it is needed. <!--- actual-bot-sections ---> <hr /> <!--- bundlestats-action-comment key:combined start ---> ### Bundle Stats Bundle | Files count | Total bundle size | % Changed ------ | ----------- | ----------------- | --------- desktop-client | 37 | 13.23 MB | 0% loot-core | 1 | 4.86 MB | 0% api | 2 | 3.87 MB | 0% cli | 1 | 7.97 MB → 7.97 MB (+40 B) | +0.00% crdt | 1 | 11.12 kB | 0% <details> <summary>View detailed bundle stats</summary> #### desktop-client **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 37 | 13.23 MB | 0% <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** No assets were bigger **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- static/js/index.js | 1.58 MB | 0% static/js/BackgroundImage.js | 121.09 kB | 0% static/js/FormulaEditor.js | 814.39 kB | 0% static/js/ManageRules.js | 46.47 kB | 0% static/js/PayeeRuleCountLabel.js | 7.1 kB | 0% static/js/ReportRouter.js | 1.25 MB | 0% static/js/ScheduleEditForm.js | 146.51 kB | 0% static/js/SchedulesTable.js | 203.52 kB | 0% static/js/TransactionEdit.js | 90.63 kB | 0% static/js/TransactionList.js | 82.8 kB | 0% static/js/Value.js | 4.49 MB | 0% static/js/_baseIsEqual.js | 76.76 kB | 0% static/js/ca.js | 185.63 kB | 0% static/js/client.js | 450.92 kB | 0% static/js/da.js | 100.19 kB | 0% static/js/de.js | 182.38 kB | 0% static/js/en-GB.js | 9.25 kB | 0% static/js/en.js | 202.14 kB | 0% static/js/es.js | 177.58 kB | 0% static/js/extends.js | 473.99 kB | 0% static/js/fr.js | 177.35 kB | 0% static/js/indexeddb-main-thread-worker-e59fee74.js | 13.46 kB | 0% static/js/it.js | 163.93 kB | 0% static/js/narrow.js | 364.55 kB | 0% static/js/nb-NO.js | 147.07 kB | 0% static/js/nl.js | 119.71 kB | 0% static/js/pt-BR.js | 187.34 kB | 0% static/js/resize-observer.js | 18.06 kB | 0% static/js/th.js | 173.33 kB | 0% static/js/theme.js | 31.01 kB | 0% static/js/toString.js | 638.95 kB | 0% static/js/uk.js | 216.7 kB | 0% static/js/useFormatList.js | 2.52 kB | 0% static/js/useTransactionBatchActions.js | 9.71 kB | 0% static/js/wide.js | 298.23 kB | 0% static/js/workbox-window.prod.es5.js | 7.33 kB | 0% static/js/zh-Hans.js | 116.44 kB | 0% </div> </details> --- #### loot-core **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 1 | 4.86 MB | 0% <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** No assets were bigger **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- kcab.worker.DhLbg59B.js | 4.86 MB | 0% </div> </details> --- #### api **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 2 | 3.87 MB | 0% <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** No assets were bigger **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- index.js | 3.87 MB | 0% models.js | 0 B | 0% </div> </details> --- #### cli **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 1 | 7.97 MB → 7.97 MB (+40 B) | +0.00% <details> <summary>Changeset</summary> File | Δ | Size ---- | - | ---- `src/config.ts` | 📈 +40 B (+1.11%) | 3.52 kB → 3.56 kB </details> <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** Asset | File Size | % Changed ----- | --------- | --------- cli.js | 7.97 MB → 7.97 MB (+40 B) | +0.00% **Smaller** No assets were smaller **Unchanged** No assets were unchanged </div> </details> --- #### crdt **Total** Files count | Total bundle size | % Changed ----------- | ----------------- | --------- 1 | 11.12 kB | 0% <details> <summary>View detailed bundle breakdown</summary> <div> **Added** No assets were added **Removed** No assets were removed **Bigger** No assets were bigger **Smaller** No assets were smaller **Unchanged** Asset | File Size | % Changed ----- | --------- | --------- index.js | 11.12 kB | 0% </div> </details> </details> <!--- bundlestats-action-comment key:combined end ---> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-06-17 21:14:06 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/actual#136448