interactive-login
GitHub处理CLI交互式登录(如AWS SSO、GitHub),通过设备码流程完成认证,将凭据保存至密钥链并通过execute.credentials供后续命令使用,确保临时环境隔离。
Trigger Scenarios
Install
npx skills add yc-software/qm --skill interactive-login -g -y
SKILL.md
Frontmatter
{
"name": "interactive-login",
"description": "Log a CLI in with a browser\/device-code flow (aws sso, gh, glab, gcloud, …) and save the result to the keychain so later commands can request it through execute.credentials."
}
Interactive login
Nothing captures logins for you. Every login runs in a fresh temporary home and is saved
to the keychain with the script shipped with this skill. Never log in against the real
$HOME, and never treat a token or config already in $HOME as a usable login: only a
keychain handle is. Use the same explicit sandbox_id for the skill read, login,
and save-login commands so the temporary home and save script stay on one computer.
-
Make a fresh directory and start the login with
execute(background:true)with every config location pointed into it. Copy in any config the CLI needs first (for AWS, the[profile …]/[sso-session …]blocks in.aws/config); everything under that directory becomes the saved login.d=$(mktemp -d) && echo "$d" in_d() { env HOME="$d" XDG_CONFIG_HOME="$d/.config" XDG_DATA_HOME="$d/.local/share" XDG_STATE_HOME="$d/.local/state" XDG_CACHE_HOME="$d/.cache" "$@"; } in_d aws sso login --profile work --use-device-code --no-browser in_d gh auth login --hostname github.com --git-protocol https --web in_d glab auth login --hostname gitlab.com --web in_d gcloud auth login --no-launch-browserUse the CLI's device-code mode (AWS needs
--use-device-code); a browser flow only completes on the same machine. -
Relay the verification URL and code from the job output. Answer any prompt with
backgroundactionsend_input. Use itswatchorpollaction with the returnedprocess_id; never stop the job while the person is approving. -
When it exits successfully, save the directory with the script under the absolute directory the skill read reported:
node <skill dir>/scripts/save-login.mjs aws "$d" --label "work (123456789012)"The script uploads only the files under that directory, removes the directory, and prints the credential handle. It also removes a directory that holds no usable login. Never remove the directory yourself; if the save fails, run the script again. Saving the same service again replaces that entry in place: its id, handle, owner and grants stay the same.
-
Use the login only by naming the handle in
credentialsonexecute(includingbackground:true), including to check that it works. The files are staged in a private home for that command or job, and refreshes the CLI writes are saved back when it ends.
Never print token files or paste their contents into the conversation. If the login fails or expires, start again from step 1 with a new directory.
Version History
-
6803edb
Current 2026-10-18 18:21
重构为基于sandbox的显式凭据管理,移除平台级捕获,统一通过execute.credentials传递和刷新凭据,支持后台作业。
- 7f2c916 2026-08-02 21:46


