1234npm install -g @sigcli/cli

# 或者无需全局安装：
npx @sigcli/cli sig --help

12345678# 1. 创建配置（交互式）
sig init

# 2. 登录——自动打开真实浏览器，捕获 cookie
sig login https://jira.example.com

# 3. 确认登录成功
sig status my-jira

12345678# 探索可用的变量
sig run my-jira -- env | grep SIG_

# 注入凭证并运行任意命令
sig run my-jira -- curl https://jira.example.com/api/me

# 运行 Python 脚本
sig run my-jira -- python fetch_issues.py

123456789101112131415# 启动代理守护进程
sig proxy start

# 信任 CA 证书（首次使用时）
sig proxy trust    # 打印 CA 证书路径——添加到系统信任存储

# 设置代理环境变量
export HTTP_PROXY=http://127.0.0.1:7891
export HTTPS_PROXY=http://127.0.0.1:7891

# 任何 HTTP 客户端都会自动获得凭证注入
curl https://jira.example.com/rest/api/2/myself

# 完成后
sig proxy stop

12345678# 简单 GET 请求
sig request https://jira.example.com/rest/api/2/myself

# POST 请求
sig request https://api.example.com/data --method POST --body '{"key": "value"}'

# 只获取响应体
sig request https://api.example.com/me --format body

12sig proxy start
export HTTP_PROXY=http://127.0.0.1:7891 HTTPS_PROXY=http://127.0.0.1:7891

1sig request https://api.example.com/me --format body

1sig run my-jira -- curl https://jira.example.com/api/me

1234# 默认脱敏
sig get my-jira
# 原始值（谨慎使用）
sig get my-jira --no-redaction

12345sig init                    # 交互式配置
sig init --remote           # 无头 / CI / 远程机器
sig init --yes              # 接受所有默认值，跳过提示
sig init --force            # 覆盖现有配置
sig init --channel chrome   # 指定浏览器（chrome|msedge|chromium）

1sig doctor

123456789101112131415161718192021sig run [provider...] -- <cmd>

# 探索可用的 SIG_<PROVIDER>_* 变量
sig run my-jira -- env | grep SIG_MY_JIRA_

# 注入凭证并运行
sig run my-jira -- python fetch_issues.py
sig run my-jira -- node export_board.js

# 同时注入多个提供者
sig run provider-a provider-b -- python cross_tool.py

# 不指定提供者——注入所有有效凭证
sig run -- python script.py

# 将单个 cookie 展开为 SIG_<PROVIDER>_COOKIE_<NAME>=value
sig run my-jira --expand-cookies -- python script.py

# 将凭证写入 .env 文件（子进程退出后自动删除）
sig run my-jira --mount .env -- node app.js
sig run my-jira --mount creds.json --mount-format json -- node app.js

12345678910111213141516171819202122232425262728293031sig login <url>

# 浏览器 SSO（自动打开浏览器）
sig login https://jira.example.com

# 强制原生 CDP 模式（绕过 X、Reddit 等网站的反自动化检测）
sig login https://x.com --mode cdp

# 仅使用无头模式（最快，但部分网站会拦截）
sig login https://jira.example.com --mode headless

# 自定义提供者 ID
sig login https://jira.example.com --as my-jira

# API 令牌 / 个人访问令牌（无需浏览器）
sig login https://jira.example.com --token <your-pat>

# 从浏览器 DevTools → Network → Copy as cURL 复制的 cookie
sig login https://jira.example.com --cookie "SESSION=abc123; csrf_token=xyz"

# HTTP 基本认证
sig login https://jira.example.com --username alice --password hunter2

# 强制指定策略
sig login https://jira.example.com --strategy cookie
sig login https://jira.example.com --strategy oauth2
sig login https://jira.example.com --strategy api-token
sig login https://jira.example.com --strategy basic

# 跳过存储的凭证检查，直接进入浏览器
sig login https://jira.example.com --force

12sig logout my-jira         # 清除单个提供者
sig logout                   # 清除所有凭证

12345sig get my-jira                        # JSON 映射（默认）
sig get my-jira --format json          # 结构化 JSON
sig get my-jira --format header        # HTTP 请求头字符串
sig get my-jira --format value         # 仅原始值
sig get jira.example.com                  # 按 URL 查询

12345678sig request <url>

sig request https://jira.example.com/api/me
sig request https://jira.example.com/api/issues/123 --format body
sig request https://jira.example.com/api/issues   --method POST   --body '{"title":"Bug","status":"open"}'   --header "Content-Type: application/json"
sig request <url> --format json     # 完整响应（状态、头、体）
sig request <url> --format body     # 仅响应体
sig request <url> --format headers  # 仅响应头

123sig status                       # 所有提供者
sig status my-jira              # 单个提供者
sig status --format json         # 机器可读

12sig providers                    # 表格视图
sig providers --format json      # 机器可读

1sig rename my-jira my-service   # 重命名提供者 ID

123sig remove my-jira              # 删除提供者和凭证
sig remove my-jira --keep-config  # 仅清除凭证
sig remove my-jira --force        # 跳过确认

12345sig remote add prod ssh://deploy@ci.example.com
sig remote add prod ci.example.com --user deploy --ssh-key ~/.ssh/id_rsa --path ~/.sig
sig remote remove prod
sig remote list
sig remote list --format json

1234sig sync push prod               # 推送所有凭证到远程
sig sync pull prod               # 从远程拉取凭证
sig sync push prod --provider my-jira   # 仅同步一个提供者
sig sync push --force            # 冲突时覆盖

1234sig watch add my-jira           # 添加到监视列表
sig watch add my-jira --auto-sync prod   # 刷新后自动同步
sig watch remove my-jira        # 从监视列表移除
sig watch set-interval 1h       # 更改默认间隔

12345678910sig proxy start                  # 启动守护进程（默认端口 7891）
sig proxy start --port 8080      # 使用自定义端口
sig proxy stop                   # 停止守护进程
sig proxy status                 # 显示运行状态、端口和环境变量提示
sig proxy trust                  # 打印 CA 证书路径和操作系统信任说明

# 用法：将任意工具指向代理
export HTTP_PROXY=http://127.0.0.1:7891
export HTTPS_PROXY=http://127.0.0.1:7891
curl https://jira.example.com/api/me   # 凭证自动注入

12345678910# Example: inject xoxc token from localStorage as form body parameter
providers:
  app-slack:
    # ... domains, strategy, etc.
    proxy:
      inject:
        - in: body           # header | body | query
          action: set         # set | append | remove
          name: token
          from: credential.localStorage.xoxc-token

1234567watch:
  interval: 5m           # check interval (default: 5m)
  providers:
    jira:
      autoSync:            # optional: sync to remotes after refresh
        - dev-server
    ms-teams:

123456789101112sig proxy trust                  # show CA cert path + instructions

# macOS
sudo security add-trusted-cert -d -r trustRoot \
  -k /Library/Keychains/System.keychain ~/.sig/proxy/ca.crt

# Ubuntu/Debian
sudo cp ~/.sig/proxy/ca.crt /usr/local/share/ca-certificates/sigcli-proxy.crt
sudo update-ca-certificates

# Per-command (no system trust)
curl --cacert ~/.sig/proxy/ca.crt https://api.example.com

123sig completion bash >> ~/.bashrc
sig completion zsh >> ~/.zshrc
sig completion fish > ~/.config/fish/completions/sig.fish

12345678910111213141516# 始终存在（以提供者 "my-jira" 为例）
SIG_MY_JIRA_PROVIDER          # 提供者 ID："my-jira"
SIG_MY_JIRA_CREDENTIAL_TYPE   # 凭证类型：cookie | bearer | api-key | basic

# Bearer / OAuth2 令牌
SIG_MY_JIRA_TOKEN             # 原始令牌值，例如 "eyJ..."
SIG_MY_JIRA_AUTH_HEADER       # 完整的 Authorization 请求头值

# Cookie 凭证
SIG_MY_JIRA_COOKIE            # 完整 cookie 字符串，例如 "SESSION=abc; ..."

# 使用 --expand-cookies 时：单独的 cookie
SIG_MY_JIRA_COOKIE_SESSION=abc123
SIG_MY_JIRA_COOKIE_CSRF_TOKEN=xyz

1234567891011import os

# 通过以下方式运行：sig run my-jira -- python fetch.py
token = os.environ.get("SIG_MY_JIRA_TOKEN")
cookie = os.environ.get("SIG_MY_JIRA_COOKIE")
auth_type = os.environ.get("SIG_MY_JIRA_CREDENTIAL_TYPE")

if auth_type == "cookie":
    headers = {"Cookie": cookie}
elif auth_type == "bearer":
    headers = {"Authorization": f"Bearer {token}"}

1234567891011# ~/.sig/config.yaml

mode: browser          # browser | browserless
browserChannel: chrome # chrome | msedge | chromium（默认：chromium）

providers:
  my-jira:
    url: https://jira.example.com
    strategy: cookie
    requiredCookies:
      - SESSION

1234567891011providers:
  <provider-id>:
    url: <base-url>              # 必填：要匹配的 URL
    strategy: cookie|oauth2|api-token|basic
    requiredCookies:             # 等待这些 cookie 出现
      - SESSION
    cookiePaths:                 # 子路径 cookie 的额外查询路径
      - /wiki
    forceVisible: true           # 始终打开可视浏览器（默认：false）
    waitUntil: networkidle       # 加载事件：load|domcontentloaded|networkidle
    ttl: 8h                      # 凭证 TTL（例如 1h、8h、7d）

1sig login https://jira.example.com --strategy cookie

1sig login https://jira.example.com --strategy oauth2

1sig login https://jira.example.com --token <your-pat>

1sig login https://jira.example.com --username alice --password hunter2

1234# 选择哪个适配器？
# → 带显示器的开发笔记本：playwright（默认）
# → 附加到已打开的 Chrome：chrome-cdp
# → 无头 CI / 远程服务器：browserless 模式 + sig sync pull

1npm install @sigcli/sdk

12345678910import { SigClient } from '@sigcli/sdk';

const sig = new SigClient();

// 获取凭证请求头
const headers = await sig.getHeaders('my-jira');
const response = await fetch('https://jira.example.com/api/me', { headers });

// 或直接使用 sig.request()
const result = await sig.request('https://jira.example.com/api/issues/123');

1pip install sigcli-sdk

12345678910from sigcli import SigClient

sig = SigClient()

# 获取请求头
headers = sig.get_headers("my-jira")
response = requests.get("https://jira.example.com/api/me", headers=headers)

# 或直接使用 sig.request()
result = sig.request("https://jira.example.com/api/issues/123")

1234567891011121314# 推荐：sig run 将凭证排除在代理上下文之外
sig run my-jira -- python fetch_issues.py
sig run my-jira -- node export_sprint.js

# 备选：sig proxy，适用于守护进程或只读取代理环境变量的工具
sig proxy start
export HTTP_PROXY=http://127.0.0.1:7891 HTTPS_PROXY=http://127.0.0.1:7891
# 现在任何遵循代理环境变量的工具都会自动注入凭证

# 探索可用的 SIG_<PROVIDER>_* 变量
sig run my-jira -- env | grep SIG_MY_JIRA_

# 备选：sig request（凭证保持内部）
sig request https://jira.example.com/api/me

12345# 行动前始终检查——避免不必要的浏览器启动
sig status my-jira --format json
# 退出码 0 + "valid": true  → 凭证就绪，跳过登录
# 退出码 3                  → 无凭证，运行 sig login
# 退出码 0 + 已过期          → sig logout my-jira && sig login https://jira.example.com

12345678# 安装所有技能（自动检测代理）
./skills/install.sh

# 指定代理
./skills/install.sh --agent cursor

# 查看已安装
./skills/install.sh --list

1mkdir -p skills/my-service/scripts

1234567891011121314151617181920---
name: my-service
description: '与 My Service 交互 — 创建、列出和更新项目。'
---

# My Service

通过 REST API 创建、列出和更新项目。

## 认证

| 提供者        | 类型   | 登录命令                                  |
|------------- |--------|----------------------------------------|
| `my-service` | cookie | `sig login https://my-service.example.com/` |

**运行脚本：**
```bash
sig run my-service -- python3 scripts/list_items.py \
  --cookie "$SIG_MY_SERVICE_COOKIE"
```

12345678910111213141516171819202122232425262728#!/usr/bin/env python3
"""列出 My Service API 中的项目。"""
import argparse, json, sys, requests

BASE = "https://my-service.example.com/api/v1"

def list_items(cookie, query=None, limit=20):
    headers = {"Cookie": cookie} if cookie else {}
    params = {"limit": limit}
    if query:
        params["q"] = query
    resp = requests.get(f"{BASE}/items", headers=headers, params=params, timeout=15)
    resp.raise_for_status()
    return {"items": resp.json().get("items", []), "count": len(resp.json().get("items", []))}

def main():
    p = argparse.ArgumentParser()
    p.add_argument("--cookie", default="")
    p.add_argument("--query")
    p.add_argument("--limit", type=int, default=20)
    args = p.parse_args()
    try:
        json.dump(list_items(args.cookie, args.query, args.limit), sys.stdout, indent=2)
    except requests.HTTPError as e:
        json.dump({"error": f"HTTP_{e.response.status_code}"}, sys.stdout, indent=2)

if __name__ == "__main__":
    main()

12# 在 skills/install.sh 的 ALL_SKILLS 中添加，然后：
./skills/install.sh

12345678910111213141516# 1. 在无头服务器上——设置无浏览器模式
sig init --remote

# 2. 在笔记本上——添加远程
sig remote add prod ssh://deploy@ci.example.com
# 或使用明确选项：
sig remote add prod ci.example.com --user deploy --ssh-key ~/.ssh/id_rsa

# 3. 推送所有凭证到服务器
sig sync push prod

# 4. 仅推送单个提供者
sig sync push prod --provider my-jira

# 5. 在服务器上——无需浏览器即可立即使用
sig run my-jira -- python deploy.py

12sig sync pull prod                # 拉取全部
sig sync pull prod --force        # 冲突时覆盖

123# 在笔记本上：每小时刷新 my-jira 并自动推送到 prod
sig watch add my-jira --auto-sync prod
sig watch start --interval 1h

123456# 退出码
0   成功
1   GENERAL_ERROR       — 无效参数或意外失败
2   PROVIDER_NOT_FOUND  — URL/ID 不匹配任何已配置的提供者
3   CREDENTIAL_NOT_FOUND — 无存储凭证 → 运行 sig login
4   REMOTE_NOT_FOUND    — SSH 远程未配置 → 运行 sig remote add

1234567891011121314151617181920212223242526CREDENTIAL_EXPIRED        # 令牌/cookie 已过期，刷新失败
                          # 修复：sig logout <p> && sig login <url>

CREDENTIAL_TYPE_MISMATCH  # 提供者的凭证类型错误
                          # 修复：使用 --strategy <name> 重新登录

REFRESH_FAILED            # OAuth2 刷新令牌被拒绝
                          # 修复：sig logout <p> && sig login <url>

BROWSER_LAUNCH_ERROR      # playwright-core 未安装或无浏览器
                          # 修复：sig doctor；安装 playwright-core

BROWSER_TIMEOUT           # 浏览器认证超时
                          # 修复：重试；如有 CAPTCHA/MFA 确保可视模式

BROWSER_UNAVAILABLE       # 机器处于无浏览器模式
                          # 修复：使用 --token/--cookie 或 sig sync pull

CONFIG_ERROR              # ~/.sig/config.yaml 格式错误
                          # 修复：sig doctor 验证

SYNC_CONFLICT             # 本地/远程凭证不同
                          # 修复：sig sync pull --force

STORAGE_ERROR             # 无法读写凭证文件
                          # 修复：检查 ~/.sig/credentials/ 的权限