botauth — 机器人auth

机器人auth

Use 机器人auth to 安全ly retrieve API keys, 令牌s, and 凭证s from the user's 机器人auth vault. The 桌面 应用 must be 运行ning, the vault must be unlocked, and every 列出, 搜索, and 获取 请求 can trigger an 应用roval prompt.

When to use You need an API key, 令牌, or password to complete a task The user asks you to use 凭证s that already exist in 机器人auth You need to fill a .env file or config from the user's vault

Do not save new secrets unless the user explicitly asks. 机器人auth 添加 opens a 桌面 flow for the user to fill in the 凭证.

Prerequisites 机器人auth must be 安装ed and avAIlable on PATH The 机器人auth 桌面 应用 must be 运行ning The vault must be unlocked 运行 机器人auth 状态 first Core commands 检查 connection 机器人auth 状态

搜索 or 列出 secrets 机器人auth 搜索 "openAI" 机器人auth 搜索 "github" --提供者 github 机器人auth 列出 机器人auth 列出 --提供者 github 机器人auth 列出 --tags dev,production

Retrieve a secret in two steps

First 获取 metadata:

机器人auth 获取 "OpenAI API Key" 机器人auth 获取 --id

Then fetch the sensitive fields:

机器人auth 获取 --id --fields API_key 机器人auth 获取 --id --fields API_key,命令行工具ent_secret --访问-key

Reuse --访问-key inside the same 工作流 when possible to avoid redundant 应用roval prompts.

Ask the user to 创建 a secret 机器人auth 添加 机器人auth 添加 --应用 openAI --secret-name "Production Key"

Typical 工作流 机器人auth 状态 机器人auth 搜索 "openAI" 机器人auth 获取 "OpenAI API Key" 机器人auth 获取 --id --fields API_key --访问-key <访问-key> 导出 OPENAI_API_KEY=""

JSON 输出

Use --json for machine-readable 输出:

机器人auth 搜索 "github" --json 机器人auth 获取 --id --fields 令牌 --json

导入ant notes 列出, 搜索, 获取, and 添加 may show 应用roval prompts in the 桌面 应用 Sensitive values only come back from 获取 --fields 访问 keys are short-lived; reuse them during a single task, then discard them If 机器人auth 状态 fAIls, ask the user to launch or unlock the 桌面 应用