Skip to content

Settings and Storage

Mel edited this page Nov 10, 2026 · 1 revision

App settings

One file: config.json, in the app's config folder. On Linux that is ~/.config/codes.escacs.stack/config.json, or under $XDG_CONFIG_HOME when that is set.

Key Holds
worker the user picked in who (null when skipped)
project the selected project folder
recentProjects up to 10 project folders, newest first
stackPath the saved stack checkout. null means automatic lookup
scanRoot, scanRoots extra folders for scan. The app has no control for these; edit the file

The file holds no credentials and no catalog data.

To reset:

  • Everything: quit the app and delete config.json. The next launch starts at who, with automatic stack lookup.
  • Only the stack folder: auto in installed, or set stackPath to null.
  • scripts/uninstall-stack-app.sh --config also forgets the stack path and recent projects. See Install.

Project files

The CLI writes into the project: stack.toml (the record of what was imported, and at which commit), the managed escacs block in .gitignore, the imported files, and the .claude/skills link for skills.

You decide what to commit. The app does not run git.

Caches and session state

  • Remote component libraries are cached by the stack CLI (CLI Overview), in $ESCACS_STACK_CACHE, or else $XDG_CACHE_HOME/escacs-stack/remotes (default ~/.cache/escacs-stack/remotes).
  • The catalog list, previews and the last operation's output live in memory for the session. The app writes none of them to disk.

Where the data comes from

Every view decodes the CLI's --json output:

View Stack command
who list worker
browse: list list (online, so new remote members appear)
browse: entry show <id>, and show <id> --file <path> for file bodies
installed rows status
presets preset list; preset apply <name>
import, adopt import
update, update all update
remove, sync, init remove, sync, init

The app adds --offline to show and status, which never need the network. list stays online. A failed command shows its error text: the CLI's stderr, or its stdout if stderr is empty.

Full CLI guide: CLI Overview.

See also: Browse, Installed, Development.

Clone this wiki locally