@@ -146,37 +146,20 @@ foundry profile active # Verify authentication
146146foundry apps list # Check existing apps (avoid name collisions)
147147```
148148
149- Before treating a missing profile as an authentication failure, normalize the
150- configuration lookup for agents that override XDG paths:
151-
152- ``` bash
153- export XDG_CONFIG_HOME=" ${XDG_CONFIG_HOME:- $HOME / .config} "
154- foundry profile active
155- ```
156-
157- The Foundry CLI reads profiles from
158- ` $XDG_CONFIG_HOME/foundry/configuration.yml ` . Do not point
159- ` XDG_CONFIG_HOME ` at the app workspace or copy credentials into it. If the
160- profile exists but the assistant cannot access that directory, request write
161- access to the existing Foundry configuration directory and retry. If either
162- command still fails, see
163- [ references/headless-operation.md] ( references/headless-operation.md ) for setup
164- options (env vars, non-interactive profile creation).
149+ Before diagnosing a missing profile, export
150+ ` XDG_CONFIG_HOME="${XDG_CONFIG_HOME:-$HOME/.config}" ` . Never redirect it into
151+ the workspace or copy credentials. See
152+ [ headless operation] ( references/headless-operation.md ) for access and
153+ authentication failures.
165154
166155### Step 4: Scaffold the App
167156
168157** Prerequisite:** User must have confirmed the app name in Step 2. Do not run this without confirmation.
169158
170- Choose the app location without asking the user:
171-
172- 1 . If the current directory contains ` manifest.yml ` , use it as an existing app.
173- 2 . If the current directory is not inside an unrelated repository, create the
174- app there.
175- 3 . If the current directory is an unrelated repository, create the app as a
176- sibling under that repository's parent directory.
177- 4 . If the selected parent is outside the assistant's writable sandbox, request
178- write access for that directory and retry the CLI command. Do not fall back
179- to putting the app inside the unrelated repository.
159+ Choose the location automatically: use an existing app when ` manifest.yml ` is
160+ present; otherwise create in the current directory, or beside it when the
161+ current directory is an unrelated repository. Request sandbox write access when
162+ needed; never put the app inside an unrelated repository as a fallback.
180163
181164``` bash
182165foundry apps create --name " app-name" --description " description" --no-prompt --no-git
0 commit comments