SuperAPI AI 工具集

glab-config

通用与其它

查看项目

更新于 10-16 01:09

技能介绍

用途:管理 glab CLI 的键值配置,涵盖全局行为与按主机行为,适合配置 glab 默认行为、设置默认值或查看当前配置。

主要能力:提供 edit(打开配置文件)、get(打印某键的值)、path(打印全局配置文件位置,--dir 打印父目录)、set(更新某键的值)四个子命令,支持 -g/--global 使用全局配置文件。全局设置包括 branch_prefix、browser、check_update、debug、editor、git_protocol、glab_pager、host、no_prompt、remote_alias、telemetry 等;按主机设置包括 api_host、api_protocol、ca_cert、client_cert、client_id、client_key、custom_headers、job_token、proxy、skip_tls_verify、ssh_host、subfolder、token、use_keyring 等。别名如 visual/glab_editor 对应 editor,gitlab_host/gitlab_uri/gl_host 对应 host,prompt_disabled 对应 no_prompt,别名不区分大小写并持久化到规范键。

使用方式:常用命令如 glab config get --global、glab config set editor vim --global、glab config set glab_pager "less -R" --global、glab config set host https://gitlab.mycompany.com --global。按主机代理示例:glab config set proxy "http://proxy.example.com:8080" --host gitlab.mycompany.com,再用 glab config get proxy --host gitlab.mycompany.com 验证。custom_headers 需在全局配置的对应主机条目下以列表形式编辑(glab config edit --global),每项含 name 及 value、valueFromEnv、valueFromCommand 三者之一。

配置查找顺序:设置 GLAB_CONFIG_DIR 时使用 $GLAB_CONFIG_DIR/config.yml;否则按 ~/.config/glab-cli/config.yml(旧位置)、$XDG_CONFIG_HOME/glab-cli/config.yml、$XDG_CONFIG_DIRS/glab-cli/config.yml 顺序取第一个存在的文件,文件不合并。仓库级设置位于 .git/glab-cli/config.yml。

限制与注意:set 会按规范 schema 校验键名,失败时应检查拼写及该键是主机级(--host)还是全局级(--global)。proxy 为按主机作用域,应使用 --host 而非 --global。自定义头值应视为凭据,避免明文写入配置、日志或仓库。非交互自动化可用 GLAB_NO_PROMPT=1。环境变量覆盖按 schema 顺序取第一个已设置项,新脚本优先使用 GLAB_ 前缀名称。具体完整别名与 --help 输出见资料所述 references/commands.md。