Skip to content

Repository files navigation

SKIBOX

Terminal API key manager for AI dev tools / 终端 AI 开发工具 API Key 管理器


Overview

SKIBOX is a Go TUI app that logs into an OpenAI-compatible backend, manages your API tokens (view, create, delete, switch), and writes the active token directly into the local config files of your AI coding tools — no manual editing required. It also has a built-in chat interface and can diagnose/repair broken tool configs.

Default backend: https://skiapi.dev. You can point it at any OpenAI-compatible service.

概述

SKIBOX 是一个 Go 写的终端界面应用,登录 OpenAI 兼容后端后可以管理 API Token(查看、创建、删除、切换),并把当前选中的 Token 直接写入本机 AI 开发工具的配置文件里——不用手动改配置。还内置了聊天功能,能诊断和自动修复工具配置问题。

默认后端是 https://skiapi.dev,也可以在应用内切换成你自己的兼容服务。


Features

  • Account login with username, password, and optional 2FA
  • View, create, delete, and switch API tokens from the terminal
  • Browse the backend's model list; select a model for built-in chat
  • Stream chat responses directly inside the TUI
  • Auto-detect installed tools and sync the active token into their configs
  • Diagnose tool configuration problems and attempt automatic repair

功能

  • 账号登录,支持用户名、密码、2FA
  • 终端里查看、创建、删除、切换 Token
  • 拉取后端模型列表,选中模型用于内置聊天
  • TUI 内直接聊天,支持流式输出
  • 自动检测本机已装工具,把当前 Token 同步到对应配置
  • 诊断配置异常,尝试自动修复

Supported Tools / 支持的工具

  • Claude Code
  • Codex
  • Cline (VS Code extension)
  • Gemini CLI
  • OpenClaw

Tech Stack / 技术栈


Project Structure / 项目结构

.
├── main.go                     # Entry point, starts Bubble Tea
├── internal/
│   ├── api/                    # HTTP client for the backend
│   ├── config/                 # Local config + chat session persistence
│   ├── fileutil/               # Atomic file writes
│   ├── keyutil/                # API key helpers
│   ├── platform/               # OS/platform detection and paths
│   ├── toolswitch/             # Writes tokens into each tool's config
│   └── ui/                     # TUI screens: login, main, chat, setup, aifix, mascot
├── docs/                       # GitHub Pages site
├── mac/                        # macOS packaging (Info.plist, icns, launcher)
├── build.bat                   # Windows build script
├── build-mac.bat               # macOS build/package script
├── go.mod / go.sum
└── LICENSE                     # MIT

Getting Started / 快速开始

Prerequisites / 前置条件

  • Go 1.24.2+ (only if building from source with system toolchain)

Build / 构建

Build scripts prefer a local Go/ toolchain in the repo root if present; otherwise they fall back to the system go.

构建脚本优先使用仓库根目录下的本地 Go/ 工具链,没有则回退到系统 go

Windows

build.bat release

Debug build / 调试版:

build.bat debug

macOS package / macOS 打包

build-mac.bat release

Direct build / 直接构建

go build -o skibox.exe

Run / 运行

go run .

Usage / 使用方法

Launch SKIBOX, log in (username, password, optional 2FA), then use the TUI to manage tokens, pick a model, chat, and sync the active token into installed tools. Ctrl+C to quit.

启动 SKIBOX,登录(用户名、密码、可选 2FA),然后在 TUI 里管理 Token、选模型、聊天、同步 Token 到已装工具。Ctrl+C 退出。


Local Data / 本地数据

All user data stays on your machine; nothing is written back to the repo.

所有用户数据只存本机,不会写回仓库。

  • Config: ~/.skibox/config.json
  • Chat sessions: ~/.skibox/sessions.json

Stores backend URL, session cookie, API key, user ID, selected model, and chat personality. Legacy path ~/.skiapi-helper/ is read for migration if new files are absent.


Status / 状态

Active personal project.

活跃的个人项目。


License / 许可证

MIT © 2026 dwgx

Releases

Packages

Contributors

Languages