convez.ai
PluginDevOps & InfraestruturaIntermediário
zhaojun2066

KN - Gerenciador de Perfis para AI CLI

zhaojun2066/kn

Alterne perfis de API para Claude/Codex sem recarregar o shell

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin que gerencia múltiplos perfis de configuração (API keys, URLs base, modelos) para ferramentas de IA como Claude Code e Codex, permitindo trocar entre diferentes ambientes sem sair do terminal. Inclui aplicativo desktop Tauri v2 com GUI para gerenciamento visual, terminal PTY integrado e rastreamento de uso de tokens.

Instalação

$npx convez-ai zhaojun2066/kn

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
v1.2.10
Issues abertas
0
Contribuidores
0

Casos de uso

  • Gerenciar múltiplas chaves de API para diferentes projetos/clientes
  • Alternar entre modelos e endpoints sem editar manualmente variáveis de ambiente
  • Rastrear consumo de tokens por projeto e modelo
  • Automatizar seleção de perfil baseada em diretório do projeto

Veredito

Solução robusta e bem pensada para quem trabalha com múltiplos contextos de IA. Desktop GUI é polido, CLI é funcional, e o sistema de file locking demonstra cuidado com concorrência. Recomendado para desenvolvedores que lidam com múltiplas contas/projetos simultaneamente.

README

A tradução para o português deste README ainda está na fila.

kn

AI CLI 工具的多 profile 管理器。在不同终端会话中为 claude / codex / qoder 无缝切换 API key、Base URL 和模型配置。

🌐 官网:https://zhaojun2066.github.io/kn/


安装

从 GitHub Releases 下载安装包:

平台格式
macOS Apple Silicon.dmg (aarch64)
macOS Intel.dmg (x86_64)

首次启动自动完成环境检测和 Shell Wrapper 安装。

或源码安装(仅 CLI + Shell Wrapper):

git clone https://github.com/zhaojun2066/kn.git
cd kn && bash install.sh && source ~/.zshrc

快速上手

profile init                # 导入已有配置
profile add my-api -i       # 交互式创建 profile
ai claude my-api            # 启动 Claude Code + 指定 profile
ai codex                    # 自动检测:项目级 → 默认 → 交互选择

Desktop 应用

Desktop 是 kn 的核心——一个基于 Tauri v2 的桌面 GUI,提供可视化的 profile 管理、内置 PTY 终端、扩展管理和用量追踪。

环境管理

  • 可视化管理 — 表格展示环境变量,敏感 key 自动打码,双击编辑
  • 4 步创建向导 — 名称 → CLI 类型 → 环境变量 → 完成
  • 系统扫描导入 — 自动发现 ~/.claude/settings.json、~/.codex/auth.json 等已有配置
  • 批量操作 — 多选删除/导出,JSON 格式导入导出
  • 项目绑定 — 读取项目 .ai-profile,自动关联 profile

扩展管理

统一管理 Skills、Agents、Hooks 等扩展能力:

  • Hooks — Claude Code / Codex 的事件触发器,支持向导创建、编辑、启用/禁用、执行日志
  • Agents & Skills — 扫描用户级和项目级配置,区分来源,内置 Agent 只读保护

双终端面板

两个独立 PTY 终端(login + interactive shell),支持多 Tab、6 套主题、终端搜索:

终端打开方式位置
Right TerminalProfile "运行"按钮主面板右侧
Bottom Terminal工具栏 / `Ctrl+``主面板下方

Quick Switcher (⌘K)

全局快速启动器——模糊搜索 profile、项目目录,按使用频率排序,回车即启。

Token 用量追踪

自动记录每次 ai 调用的 token 消耗,支持按模型/按项目维度查看,可配置价格计算费用。


CLI 命令

profile list                    # 列出所有 profile
profile show <name>             # 查看详情(key 打码)
profile add <name> -i           # 交互式创建
profile set <name> KEY=VALUE    # 设置环境变量
profile remove <name>           # 删除
profile default [name]          # 查看/切换默认

Shell Wrapper ai 命令:

ai claude <profile>             # 指定 profile 启动 Claude Code
ai codex <profile>              # 指定 profile 启动 Codex
ai claude                       # 自动检测 profile
ai profile list                 # 列出 profile
ai profile switch <name>        # 切换默认
ai tips                         # 模型推荐 + 使用排行

直接运行 claude / codex 不受影响,不经过 wrapper。


项目级自动切换

在项目根目录创建 .ai-profile 文件,写入 profile 名,该目录下 ai claude 自动使用对应 profile:

echo "work" > ~/project/.ai-profile
cd ~/project && ai claude   # 自动使用 work profile

优先级:显式指定 > .ai-profile > 默认 profile > 交互选择


FAQ

API key 安全吗? key 明文存储在 ~/.kn/config.yaml,建议 chmod 700 ~/.kn。

多终端同时改配置会冲突吗? 不会,文件锁保护并发写入,3 代轮转备份防数据丢失。

如何查看 token 用量? Desktop 应用中的用量面板,支持按模型/按项目维度。

支持哪些 AI 工具? Claude Code、Codex CLI、Qoder CN(国产),任何兼容协议的 API 服务。


MIT License

Ver o original no GitHub

Bom para

Relacionados