config.yml — Personal Local Config

.foundry/config.yml is gitignored — it holds personal preferences, credential pointers, and local overrides that differ between developers.

This file is never created automatically by Foundry. Create it yourself when you need it.

Example

# .foundry/config.yml — GITIGNORED
# Personal settings, credential pointers, dev overrides.
# Do NOT commit this file.
---
github:
  token: ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Future: personal overrides
# editor: code
# defaultProfile: local

GitHub Token

The simplest way to persist a GitHub token for Foundry is:

foundry github auth --token ghp_... --save

This writes the token into .foundry/config.yml. Alternatively, use the GITHUB_TOKEN environment variable or the GitHub CLI (gh auth login).

Security

The nested .foundry/.gitignore excludes config.ymlby name. It will never be tracked by Git, even if you git add ..