Repository navigation
Settings and Storage
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:
autoin installed, or setstackPathtonull. -
scripts/uninstall-stack-app.sh --configalso forgets the stack path and recent projects. See Install.
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.
- 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.
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.
Stack desktop client + CLI wiki — condensed from the repo docs. App repo: https://github.com/escacs/stack-app. CLI repo (private): https://github.com/escacs/stack.