@lkangd/cc-env 1.2.0 → 1.2.1

package/README.md

@@ -0,0 +1,110 @@
+<p align="center">
+  <img src="./statics/logo.png" alt="cc-env" width="320" />
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@lkangd/cc-env"><img src="https://img.shields.io/npm/v/@lkangd/cc-env.svg" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@lkangd/cc-env"><img src="https://img.shields.io/npm/dm/@lkangd/cc-env.svg" alt="npm downloads" /></a>
+  <a href="https://github.com/lkangd/cc-env/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@lkangd/cc-env.svg" alt="license" /></a>
+</p>
+
+<p align="center">Manage runtime environment variables for <a href="https://claude.ai/code">Claude Code</a></p>
+
+<p align="center">
+  <a href="./README.md">English</a> | <a href="./README.zh.md">简体中文</a>
+</p>
+
+---
+
+## Overview
+
+`cc-env` is a CLI tool that lets you define, switch, and restore environment variable configurations for Claude Code — per project or via reusable presets. No more manually editing `settings.json` or juggling `.env` files across workspaces.
+
+## Installation
+
+### via npm
+
+```bash
+npm install -g @lkangd/cc-env
+```
+
+Requires Node.js `>=20.19.2`.
+
+### via Homebrew
+
+```bash
+brew tap lkangd/tap
+brew install cc-env
+```
+
+## Quick Start
+
+```bash
+# 1. Initialize cc-env in your project
+cc-env init
+
+# 2. Create a preset with your environment variables
+cc-env create
+
+# 3. Run Claude Code with the preset applied
+cc-env run
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `cc-env init` | Initialize cc-env for the current project |
+| `cc-env run [args...]` | Run Claude Code with merged environment variables |
+| `cc-env restore` | Restore environment variables from a previous snapshot |
+| `cc-env show` | List and view all saved presets |
+| `cc-env create` | Create a new environment preset |
+| `cc-env edit <name>` | Edit an existing preset |
+| `cc-env rename <from> <to>` | Rename a preset |
+| `cc-env delete` | Delete a saved preset |
+| `cc-env doctor` | Check system health and configuration |
+| `cc-env completion` | Generate shell completion script |
+
+## Global Options
+
+```
+--verbose        Enable verbose output
+--quiet          Suppress non-essential output
+--no-interactive Disable interactive prompts (equivalent to -y)
+```
+
+## Shell Completion
+
+```bash
+# bash
+cc-env completion bash >> ~/.bashrc
+
+# zsh
+cc-env completion zsh >> ~/.zshrc
+
+# fish
+cc-env completion fish >> ~/.config/fish/completions/cc-env.fish
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in dev mode
+npm run dev
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+```
+
+## License
+
+ISC © [lkangd](https://github.com/lkangd)

package/README.zh.md

@@ -0,0 +1,110 @@
+<p align="center">
+  <img src="./statics/logo.png" alt="cc-env" width="320" />
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@lkangd/cc-env"><img src="https://img.shields.io/npm/v/@lkangd/cc-env.svg" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@lkangd/cc-env"><img src="https://img.shields.io/npm/dm/@lkangd/cc-env.svg" alt="npm downloads" /></a>
+  <a href="https://github.com/lkangd/cc-env/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@lkangd/cc-env.svg" alt="license" /></a>
+</p>
+
+<p align="center">为 <a href="https://claude.ai/code">Claude Code</a> 管理运行时环境变量</p>
+
+<p align="center">
+  <a href="./README.md">English</a> | <a href="./README.zh.md">简体中文</a>
+</p>
+
+---
+
+## 概述
+
+`cc-env` 是一个 CLI 工具，让你可以为 Claude Code 定义、切换和恢复环境变量配置——支持按项目配置或使用可复用的预设。不再需要手动编辑 `settings.json` 或在不同工作区之间切换 `.env` 文件。
+
+## 安装
+
+### 通过 npm
+
+```bash
+npm install -g @lkangd/cc-env
+```
+
+需要 Node.js `>=20.19.2`。
+
+### 通过 Homebrew
+
+```bash
+brew tap lkangd/tap
+brew install cc-env
+```
+
+## 快速开始
+
+```bash
+# 1. 在项目中初始化 cc-env
+cc-env init
+
+# 2. 创建一个包含环境变量的预设
+cc-env create
+
+# 3. 使用预设运行 Claude Code
+cc-env run
+```
+
+## 命令
+
+| 命令 | 说明 |
+|---|---|
+| `cc-env init` | 为当前项目初始化 cc-env |
+| `cc-env run [args...]` | 使用合并后的环境变量运行 Claude Code |
+| `cc-env restore` | 从之前的快照恢复环境变量 |
+| `cc-env show` | 列出并查看所有保存的预设 |
+| `cc-env create` | 创建新的环境变量预设 |
+| `cc-env edit <name>` | 编辑现有预设 |
+| `cc-env rename <from> <to>` | 重命名预设 |
+| `cc-env delete` | 删除保存的预设 |
+| `cc-env doctor` | 检查系统健康状况和配置 |
+| `cc-env completion` | 生成 shell 补全脚本 |
+
+## 全局选项
+
+```
+--verbose        启用详细输出
+--quiet          抑制非必要输出
+--no-interactive 禁用交互式提示（等同于 -y）
+```
+
+## Shell 补全
+
+```bash
+# bash
+cc-env completion bash >> ~/.bashrc
+
+# zsh
+cc-env completion zsh >> ~/.zshrc
+
+# fish
+cc-env completion fish >> ~/.config/fish/completions/cc-env.fish
+```
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式运行
+npm run dev
+
+# 构建
+npm run build
+
+# 运行测试
+npm test
+
+# 运行测试并生成覆盖率报告
+npm run test:coverage
+```
+
+## 许可证
+
+ISC © [lkangd](https://github.com/lkangd)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lkangd/cc-env",
-  "version": "1.2.0",
-  "description": "",
+  "version": "1.2.1",
+  "description": "Manage runtime environment variables for Claude Code",
   "homepage": "https://github.com/lkangd/cc-env#readme",
   "bugs": {
     "url": "https://github.com/lkangd/cc-env/issues"
@@ -17,7 +17,7 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=20.19.2 <21"
+    "node": ">=20.19.2"
   },
   "bin": {
     "cc-env": "dist/cli.js"
@@ -54,6 +54,7 @@
     "@types/gradient-string": "^1.1.6",
     "@types/node": "^20.19.0",
     "@types/react": "^19.1.10",
+    "@vitest/coverage-istanbul": "^3.2.4",
     "@vitest/coverage-v8": "^3.2.4",
     "execa": "^9.6.0",
     "react-test-renderer": "^19.2.5",

package/dist/commands/debug.js

@@ -1,17 +0,0 @@
-import { toProcessEnvMap } from '../core/process-env.js';
-import { renderEnvSummary } from '../ink/summary.js';
-export function createDebugCommand({ projectEnvService, processEnv }) {
-    return async function debug() {
-        const projectEnv = await projectEnvService.read();
-        await renderEnvSummary({
-            title: 'Process Environment',
-            description: 'Current process environment variables',
-            env: toProcessEnvMap(processEnv)
-        });
-        await renderEnvSummary({
-            title: 'Project Environment',
-            description: 'Environment variables from .cc-env/env.json',
-            env: projectEnv
-        });
-    };
-}

package/dist/commands/preset/list.js

@@ -1,16 +0,0 @@
-export function createListPresetsCommand({ presetService, projectEnvService, renderList, }) {
-    return async function listPresets() {
-        const names = await presetService.listNames();
-        const globalPresets = await Promise.all(names.map((name) => presetService.read(name).then((p) => ({ name, env: p.env, source: 'global' }))));
-        const { env: projectEnv, name: projectName } = await projectEnvService.readWithMeta();
-        const projectPreset = Object.keys(projectEnv).length > 0
-            ? [{ name: projectName ?? 'project', env: projectEnv, source: 'project' }]
-            : [];
-        const presets = [...projectPreset, ...globalPresets];
-        if (presets.length === 0) {
-            console.log('No presets found.');
-            return;
-        }
-        await renderList(presets);
-    };
-}

package/dist/core/lock.js

@@ -1,25 +0,0 @@
-import { open } from 'node:fs/promises';
-import lockfile from 'proper-lockfile';
-import { ensureParentDir } from './fs.js';
-export async function withFileLock(filePath, run) {
-    await ensureParentDir(filePath);
-    const handle = await open(filePath, 'a+');
-    try {
-        const release = await lockfile.lock(filePath, {
-            realpath: false,
-            retries: {
-                retries: 3,
-                factor: 1,
-            },
-        });
-        try {
-            return await run();
-        }
-        finally {
-            await release();
-        }
-    }
-    finally {
-        await handle.close();
-    }
-}

package/dist/ink/preset-list-app.js

@@ -1,27 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useMemo, useState } from 'react';
-import { Box, Text, useApp, useInput } from 'ink';
-import { EnvEntries } from './summary.js';
-export function PresetListApp({ presets, }) {
-    const { exit } = useApp();
-    const [cursor, setCursor] = useState(0);
-    const activePreset = presets[cursor];
-    const entries = useMemo(() => activePreset
-        ? Object.entries(activePreset.env).sort(([a], [b]) => a.localeCompare(b))
-        : [], [activePreset]);
-    useInput((input, key) => {
-        if (key.escape || input.toLowerCase() === 'q') {
-            exit();
-            return;
-        }
-        if (key.upArrow || input === 'k') {
-            setCursor((c) => Math.max(0, c - 1));
-            return;
-        }
-        if (key.downArrow || input === 'j') {
-            setCursor((c) => Math.min(presets.length - 1, c + 1));
-            return;
-        }
-    });
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Preset list" }), _jsx(Text, { dimColor: true, children: "\u2191/k \u2193/j navigate \u00B7 q exit" }), _jsxs(Box, { marginTop: 1, children: [_jsxs(Box, { flexDirection: "column", width: 28, marginRight: 2, children: [_jsx(Text, { bold: true, color: "cyan", children: "Presets" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: presets.map((preset, index) => (_jsxs(Box, { children: [_jsx(Text, { children: index === cursor ? '❯ ' : '  ' }), _jsx(Text, { ...(preset.source === 'project' ? { color: 'yellow' } : {}), children: preset.name }), _jsxs(Text, { dimColor: true, children: [" (", preset.source, ")"] })] }, `${preset.source}:${preset.name}`))) })] }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, borderStyle: "round", borderColor: "green", paddingX: 1, children: [_jsx(Text, { bold: true, color: "green", children: activePreset?.name ?? 'Preview' }), _jsx(Text, { dimColor: true, children: activePreset?.source === 'project' ? 'Project preset' : 'Global preset' }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(EnvEntries, { entries: entries }) })] })] })] }));
-}

package/dist/services/config-service.js

@@ -1,26 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { configSchema } from '../core/schema.js';
-import { atomicWriteFile } from '../core/fs.js';
-import { resolveConfigPath } from '../core/paths.js';
-export function createConfigService(globalRoot) {
-    const filePath = resolveConfigPath(globalRoot);
-    return {
-        async read() {
-            try {
-                const content = await readFile(filePath, 'utf8');
-                return configSchema.parse(JSON.parse(content));
-            }
-            catch (error) {
-                if (error.code === 'ENOENT') {
-                    return configSchema.parse({});
-                }
-                throw error;
-            }
-        },
-        async write(config) {
-            const parsed = configSchema.parse(config);
-            await atomicWriteFile(filePath, `${JSON.stringify(parsed, null, 2)}\n`);
-            return parsed;
-        },
-    };
-}

package/dist/services/runtime-env-service.js

@@ -1,13 +0,0 @@
-import { envMapSchema } from '../core/schema.js';
-export function createRuntimeEnvService() {
-    return {
-        merge({ processEnv, settingsEnv, projectEnv, presetEnv, }) {
-            return envMapSchema.parse({
-                ...processEnv,
-                ...settingsEnv,
-                ...projectEnv,
-                ...presetEnv,
-            });
-        },
-    };
-}