# @ailuntz/minilink

> Use your Codex profiles in the Desktop model menu.

Latest version **0.9.4** (published 2026-09-23) · MIT AND Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @ailuntz/minilink
pnpm add @ailuntz/minilink
yarn add @ailuntz/minilink
bun add @ailuntz/minilink
```

Provides the command `minilink`.

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.9.4 |
| Published | 2026-09-23 |
| First published | 2026-09-23 |
| Weekly downloads | 0 |
| License | MIT AND Apache-2.0 |
| TypeScript types | none |
| Module format | ESM |
| Node | >=22.16 |
| Dependencies | 1 |
| Unpacked size | 116.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | yes |
| Maintainers | ailuntz |

## Links

- npm: https://www.npmjs.com/package/@ailuntz/minilink
- npm.io page: https://npm.io/package/@ailuntz/minilink

## Dependencies (1)

- [smol-toml](https://npm.io/package/smol-toml.md) 1.8.0

## Recent versions

- 0.9.4 (latest) — 2026-09-23
- 0.9.3 — 2026-09-23
- 0.9.2 — 2026-09-23
- 0.9.0 — 2026-09-23
- 0.8.1 — 2026-09-23
- 0.8.0 — 2026-09-23

## README

# MiniLink

在 ChatGPT / Codex Desktop 的原生模型菜单中使用自定义模型。

## 说明

官方 [Profiles](https://learn.chatgpt.com/docs/config-file/config-advanced?site_locale=en#profiles) 已支持独立配置文件：`codex --profile deep-review` 会在 `~/.codex/config.toml` 上叠加 `~/.codex/deep-review.config.toml`。配置使用顶层字段，无需嵌套在 `[profiles.deep-review]` 中。

**截至 2026-09-24，仅添加 Profile 不会将额外供应商的模型加入 Desktop 菜单。MiniLink 读取这些配置，补充桌面端的模型选择能力。**


## 安装

需 Node.js ≥22.16，并已安装 Desktop。

macOS / Windows / Linux：

```sh
npm install -g @ailuntz/minilink
minilink on
```

完全退出并重开 Desktop。

## 命令

| 命令 | 用途 |
| --- | --- |
| `minilink on` | 开启 |
| `minilink link` | 选择模型与推理强度 |
| `minilink off` | 关闭 |
| `minilink doctor` | 检查配置与运行状态 |

通过 `minilink link` 保存选择后，完全退出并重开 Desktop。

## 配置

读取 `~/.codex/*.config.toml`。通过 `model_catalog_json` 指定模型目录；未指定时继承原生目录。密钥使用提供商配置的环境变量，也可保存在 `~/.codex/.env`。

支持 Responses API。符合条件的连接提供 `-Chat` 选项，用于纯文字聊天。

供应商示例：[DeepSeek / 豆包 / Sub2API](examples/providers/)。修改配置后重启 Desktop。

## 卸载

macOS：

```sh
npm uninstall -g @ailuntz/minilink
```

卸载后完全退出并重开 Desktop。

---
_Source: https://npm.io/package/@ailuntz/minilink · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._