Skip to main content

Module config

Module config 

Source
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.