deplyze-code 0.1.0 → 0.1.3

package/README.md

@@ -1,210 +1,161 @@
-# Deplyze Code
-
-<p align="right"><strong>中文</strong> | <a href="./README.en.md">English</a></p>
-
-Deplyze Code 是一个基于 Gemini API Key 的终端编码助手，保留了原始风格的 Ink TUI 和 REPL 交互体验。
-
-> 当前主流程已经切换到 Gemini API Key 运行路径，核心终端 UI、斜杠命令、工具调用和 `/model` 交互保持可用。
-
-<p align="center">
-  <img src="docs/00runtime.png" alt="运行截图" width="800">
-</p>
-
-## 功能
-
-- 完整的 Ink TUI 与交互式 REPL
-- `--print` 无头模式，适合脚本和 CI
-- 支持斜杠命令、工具、MCP、插件与 Skills
-- 支持通过 `/model` 切换 Gemini 模型
-- 保留简化版 Recovery CLI
-
----
-
-## 快速开始
-
-### 1. 安装 Bun
-
-本项目依赖 [Bun](https://bun.sh)。
-
-```bash
-# macOS / Linux
-curl -fsSL https://bun.sh/install | bash
-```
-
-```bash
-# macOS（Homebrew）
-brew install bun
-```
-
-```powershell
-# Windows（PowerShell）
-powershell -c "irm bun.sh/install.ps1 | iex"
-```
-
-安装完成后确认：
-
-```bash
-bun --version
-```
-
-### 2. 安装依赖
-
-```bash
-bun install
-```
-
-### 3. 配置环境变量
-
-复制示例文件：
-
-```bash
-cp .env.example .env
-```
-
-至少配置：
-
-```env
-GEMINI_API_KEY=your_api_key_here
-```
-
-可选配置：
-
-```env
-GEMINI_MODEL=gemini-3.1-pro-preview
-GEMINI_SMALL_FAST_MODEL=gemini-3.1-flash-lite-preview
-DISABLE_TELEMETRY=1
-CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
-```
-
-### 4. 从源码启动
-
-#### macOS / Linux
-
-```bash
-./bin/deplyze
-```
-
-```bash
-./bin/deplyze -p "hello"
-```
-
-```bash
-echo "inspect this repository" | ./bin/deplyze -p
-```
-
-```bash
-./bin/deplyze --help
-```
-
-#### Windows
-
-```powershell
-bun ./bin/deplyze
-```
-
-```powershell
-bun ./bin/deplyze -p "hello"
-```
-
-```powershell
-bun ./bin/deplyze --help
-```
-
-### 5. 全局安装
-
-```bash
-npm install -g deplyze-code
-```
-
-安装后直接运行：
-
-```bash
-deplyze
-```
-
----
-
-## 环境变量
-
-| 变量 | 必填 | 说明 |
-|------|------|------|
-| `GEMINI_API_KEY` | 是 | 主交互运行路径所需的 Gemini API Key |
-| `GEMINI_MODEL` | 否 | 默认主模型覆盖 |
-| `GEMINI_SMALL_FAST_MODEL` | 否 | 快速验证/低成本模型覆盖 |
-| `DISABLE_TELEMETRY` | 否 | 设为 `1` 可禁用遥测 |
-| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 否 | 设为 `1` 可禁用非必要网络请求 |
-
----
-
-## 模型
-
-当前 `/model` 主流程提供：
-
-- `Gemini 3.1 Pro`
-- `Gemini 3 Flash`
-- `Gemini 3.1 Flash-Lite`
-
-运行时实际使用的 Gemini API 模型句柄为：
-
-- `gemini-3.1-pro-preview`
-- `gemini-3-flash-preview`
-- `gemini-3.1-flash-lite-preview`
-
----
-
-## 降级模式
-
-如果完整 TUI 异常，可以使用简化版 Recovery CLI：
-
-```bash
-CLAUDE_CODE_FORCE_RECOVERY_CLI=1 ./bin/deplyze
-```
-
-PowerShell：
-
-```powershell
-$env:CLAUDE_CODE_FORCE_RECOVERY_CLI='1'
-bun ./bin/deplyze
-```
-
----
-
-## 项目结构
-
-```text
-bin/deplyze              # 发布入口脚本
-preload.ts               # Bun preload（设置 MACRO 全局变量）
-.env.example             # 环境变量模板
-src/
-├── entrypoints/cli.tsx  # CLI 主入口
-├── main.tsx             # TUI 主逻辑（Commander.js + React/Ink）
-├── localRecoveryCli.ts  # Recovery CLI
-├── screens/REPL.tsx     # 交互式 REPL 界面
-├── components/          # UI 组件
-├── commands/            # 斜杠命令
-├── tools/               # Agent 工具（Bash、Edit、Grep 等）
-├── services/            # 服务层
-├── hooks/               # React hooks
-└── utils/               # 工具函数
-```
-
----
-
-## 技术栈
-
-| 类别 | 技术 |
-|------|------|
-| 运行时 | [Bun](https://bun.sh) |
-| 语言 | TypeScript |
-| 终端 UI | React + [Ink](https://github.com/vadimdemedes/ink) |
-| CLI 解析 | Commander.js |
-| API | Gemini + [`@google/genai`](https://www.npmjs.com/package/@google/genai) |
-| 协议 | MCP, LSP |
-
----
-
-## 说明
-
-- 当前主流程只要求 `GEMINI_API_KEY`。
-- 仓库中仍保留旧登录与旧 onboarding 代码，但正常 Gemini 使用不依赖它们。
-- `CLAUDE.md` 文件名出于兼容性考虑暂时保持不变。
+# Deplyze Code
+
+Deplyze Code is a Gemini-powered terminal coding assistant with an interactive Ink TUI, REPL, tools, and slash commands.
+
+This package is intended to be installed globally and started with:
+
+```bash
+deplyze
+```
+
+## Status
+
+- Current private release: `0.1.3`
+- Active auth path: Gemini API key
+- Active model picker: Gemini 3.1 Pro, Gemini 3 Flash, Gemini 3.1 Flash-Lite
+- `CLAUDE.md` remains the repository guidance filename for compatibility
+
+## Install
+
+Install Bun first if it is not already available:
+
+```bash
+curl -fsSL https://bun.sh/install | bash
+```
+
+```powershell
+powershell -c "irm bun.sh/install.ps1 | iex"
+```
+
+Install the package globally:
+
+```bash
+npm install -g deplyze-code
+```
+
+## Required Environment Variable
+
+Set your Gemini API key:
+
+```bash
+export GEMINI_API_KEY="your_api_key_here"
+```
+
+PowerShell:
+
+```powershell
+$env:GEMINI_API_KEY="your_api_key_here"
+```
+
+Optional:
+
+```bash
+export GEMINI_MODEL="gemini-3.1-pro-preview"
+export GEMINI_SMALL_FAST_MODEL="gemini-3.1-flash-lite-preview"
+```
+
+## Start
+
+Run:
+
+```bash
+deplyze
+```
+
+On first launch with `GEMINI_API_KEY` set, Deplyze Code should open directly into the main REPL without the legacy onboarding flow.
+
+## If `deplyze` Is Not Found
+
+If global install succeeds but the shell says `deplyze` is not recognized, your npm global bin directory is probably not on `PATH`.
+
+Check the prefix:
+
+```bash
+npm prefix -g
+```
+
+Make sure the corresponding global bin directory is on your shell `PATH`, then reopen the terminal.
+
+## Basic Usage
+
+Plain interactive launch:
+
+```bash
+deplyze
+```
+
+Single prompt:
+
+```bash
+deplyze -p "hello"
+```
+
+Repository question:
+
+```bash
+deplyze -p "Inspect this repository and tell me what file launches the REPL."
+```
+
+Bash tool example:
+
+```bash
+deplyze -p "Use the Bash tool to print the current working directory, then answer with only that path." --allowedTools Bash --dangerously-skip-permissions
+```
+
+## Model Switching
+
+Inside the interactive UI, run:
+
+```text
+/model
+```
+
+Available models in the active UI:
+
+- `Gemini 3.1 Pro`
+- `Gemini 3 Flash`
+- `Gemini 3.1 Flash-Lite`
+
+Underlying Gemini API model handles:
+
+- `gemini-3.1-pro-preview`
+- `gemini-3-flash-preview`
+- `gemini-3.1-flash-lite-preview`
+
+## What This Release Uses
+
+- Provider flow: Gemini API key
+- Required auth for normal usage: `GEMINI_API_KEY`
+- UI flow: existing Deplyze Code TUI and REPL
+- Legacy login and OAuth code still exists in the repository, but it is not required for the standard Gemini path
+
+## Source Checkout Usage
+
+If you are running from a local checkout instead of a global install:
+
+```bash
+bun install
+./bin/deplyze
+```
+
+Windows:
+
+```powershell
+bun install
+bun ./bin/deplyze
+```
+
+## Recovery Mode
+
+If you need the simplified recovery CLI:
+
+```bash
+CLAUDE_CODE_FORCE_RECOVERY_CLI=1 deplyze
+```
+
+PowerShell:
+
+```powershell
+$env:CLAUDE_CODE_FORCE_RECOVERY_CLI='1'
+deplyze
+```

package/bin/deplyze

@@ -8,8 +8,10 @@ import { fileURLToPath } from 'node:url'
 const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..')
 const cwd = process.cwd()
 const envFile = join(cwd, '.env')
+const preloadFile = join(packageRoot, 'preload.ts')
 
 const args: string[] = []
+args.push(`--preload=${preloadFile}`)
 if (existsSync(envFile)) {
   args.push(`--env-file=${envFile}`)
 }

package/package.json

@@ -1,14 +1,17 @@
 {
-  "name": "deplyze-code",
-  "version": "0.1.0",
-  "type": "module",
-  "bin": {
-    "deplyze": "./bin/deplyze"
-  },
-  "scripts": {
-    "deplyze": "bun run ./bin/deplyze",
-    "start": "bun run ./bin/deplyze"
-  },
+  "name": "deplyze-code",
+  "version": "0.1.3",
+  "description": "Deplyze Code is a Gemini-powered terminal coding assistant with an interactive Ink TUI.",
+  "type": "module",
+  "bin": {
+    "deplyze": "bin/deplyze"
+  },
+  "scripts": {
+    "test": "bun test",
+    "smoke": "bun run ./scripts/smoke.ts",
+    "deplyze": "bun run ./bin/deplyze",
+    "start": "bun run ./bin/deplyze"
+  },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.44",
     "@anthropic-ai/sdk": "^0.80.0",

package/preload.ts

@@ -1,5 +1,5 @@
-const version = process.env.CLAUDE_CODE_LOCAL_VERSION ?? '0.1.0';
-const packageUrl = process.env.CLAUDE_CODE_LOCAL_PACKAGE_URL ?? 'deplyze-code';
+const version = process.env.CLAUDE_CODE_LOCAL_VERSION ?? '0.1.3';
+const packageUrl = process.env.CLAUDE_CODE_LOCAL_PACKAGE_URL ?? 'deplyze-code';
 const buildTime = process.env.CLAUDE_CODE_LOCAL_BUILD_TIME ?? new Date().toISOString();
 
 process.env.CLAUDE_CODE_LOCAL_SKIP_REMOTE_PREFETCH ??= '1';