Expand description
User-global config for personal platform preferences and secrets.
Stores install targets (platform + scope) and optional platform tokens in a
TOML config file so collaborative repos don’t need install lines in the
committed Skillfile.
Config file location (via dirs::config_dir()):
- Linux:
~/.config/skillfile/config.toml - macOS:
~/Library/Application Support/skillfile/config.toml - Windows:
{FOLDERID_RoamingAppData}/skillfile/config.toml
Precedence: Skillfile install targets (if present) > user config > error.
§Format
github_token = "ghp_..."
gitlab_token = "glpat-..."
gitlab_host = "gitlab.example.com"
[[install]]
platform = "claude-code"
scope = "global"
[[install]]
platform = "cursor"
scope = "local"Functions§
- config_
path - Returns the path to the user config file.
- parse_
and_ resolve - Parse the manifest and resolve install targets from user config.
- read_
config_ token - Read the GitHub token from the user-global config file.
- read_
gitlab_ config_ host - Read the GitLab host from the user-global config file.
- read_
gitlab_ config_ token - Read the GitLab token from the user-global config file.
- read_
user_ targets - Read install targets from the user-global config file.
- read_
user_ targets_ from - Read install targets from a TOML config file at the given path.
- resolve_
targets_ into - If the manifest has no install targets, fill them from the user config.
- write_
config_ token - Write a GitHub token to the user-global config file.
- write_
gitlab_ config_ token - Write a GitLab token to the user-global config file.
- write_
user_ targets - write_
user_ targets_ to - Write install targets to the given TOML config file path.