@praeviso/code-env-switch 0.1.0 → 0.1.2

package/.eslintrc.cjs

@@ -0,0 +1,18 @@
+module.exports = {
+  root: true,
+  env: {
+    node: true,
+    es2021: true,
+  },
+  parser: "@typescript-eslint/parser",
+  parserOptions: {
+    ecmaVersion: 2021,
+    sourceType: "module",
+  },
+  plugins: ["@typescript-eslint"],
+  extends: ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
+  ignorePatterns: ["bin/", "node_modules/"],
+  rules: {
+    "no-constant-condition": ["error", { "checkLoops": false }]
+  }
+};

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,25 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+          cache: "npm"
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "typescript.enablePromptUseWorkspaceTsdk": true
+}

package/AGENTS.md

@@ -0,0 +1,32 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `src/` holds TypeScript sources. Key areas: `src/cli/` argument parsing, `src/commands/` CLI actions, `src/config/` config IO, `src/profile/` profile resolution, `src/shell/` shell integration, `src/ui/` prompts, `src/usage/` logging.
+- `bin/` contains compiled JavaScript from `tsc`; treat it as generated output.
+- `code-env.example.json` is the public config template; `README.md` and `README_zh.md` are user docs.
+
+## Build, Test, and Development Commands
+- `npm install` installs dependencies.
+- `npm run build` compiles `src/` to `bin/` using `tsconfig.json`.
+- `npm run lint` runs ESLint; `npm run lint:fix` auto-fixes.
+- `npm link` (or `npm install -g .`) installs the CLI locally for manual testing.
+- No automated test script is configured yet.
+
+## Coding Style & Naming Conventions
+- Follow existing formatting: 4-space indentation, double quotes, and semicolons.
+- Use `camelCase` for variables/functions and `PascalCase` for types/interfaces.
+- CLI commands are single verbs (`add`, `use`, `unset`); flags are `--kebab-case` (e.g., `--config`, `--shell`).
+- Keep changes ESLint-clean.
+
+## Testing Guidelines
+- There is no test framework configured. If you add tests, also add a `npm test` script and document the framework in `README.md`.
+- Prefer a top-level `tests/` folder or `src/**/__tests__` for discoverable structure.
+
+## Commit & Pull Request Guidelines
+- Git history shows Conventional Commit-style prefixes (e.g., `feat:`) plus simple descriptive messages; release commits use version numbers like `0.1.1`.
+- Use short, imperative subjects and include a brief body for non-trivial changes.
+- PRs should include: summary, rationale, manual test commands run (e.g., `npm run build`, `codenv use`), and any config or shell-rc impacts; link related issues.
+
+## Configuration & Security Notes
+- Config is loaded via `--config`, `CODE_ENV_CONFIG`, or `~/.config/code-env/config.json`; use `code-env.example.json` for sanitized examples.
+- Never commit real API keys or user-specific config.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Krito.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PLAN.md

@@ -0,0 +1,33 @@
+# Statusline Plan (Simplified)
+
+## Goals
+- Provide a host-agnostic statusline outputter for Codex CLI and Claude Code.
+- Show Git status, model label, and usage in a single line.
+- Auto-enable a bottom statusline when launching via `codenv`.
+
+## Done (implemented)
+- `codenv statusline` outputs text/JSON with Git + model + usage.
+- ANSI bottom-bar renderer added with forced redraw support (for Codex UI repaint).
+- `codenv launch codex` auto-starts the renderer.
+- `codenv launch claude` ensures `.claude/settings.json` uses a `statusLine` command object.
+- Env knobs added for enable/disable, interval, offset/reserve, and force redraw.
+
+## Next plan (overall)
+### Phase 1 — Stabilize behavior
+- Verify Codex overlay behavior across terminals; tune default interval/offset as needed.
+- Add a simple “compatibility fallback” note for terminals that don’t support scroll regions.
+- Confirm Claude statusLine object format across versions (no string form).
+
+### Phase 2 — Data quality
+- Optional: resolve model from session logs if not provided by env/stdin.
+- Clarify usage sync strategy (per-session vs aggregate) and align with `src/usage/`.
+
+### Phase 3 — Integrations & ergonomics
+- Provide generic wrapper example for other CLIs (stdin JSON contract).
+- Optional tmux statusline snippet as alternative for Codex.
+- Add minimal config knobs to `code-env.example.json` if needed.
+
+### Phase 4 — QA & polish
+- Manual test checklist (bash/zsh/fish, macOS/Linux).
+- Performance check target (<50ms typical render).
+- Harden error handling and safe fallbacks.

package/README.md

@@ -2,19 +2,60 @@
 
 A tiny CLI to switch between Claude Code and Codex environment variables.
 
-## Setup
+[中文说明](README_zh.md)
 
-1) Copy the example config and fill in your keys:
+## Features
+
+- Manage multiple profiles and switch by name or type
+- `codenv use` prints shell commands for the current terminal
+- Interactive profile creation and selection
+- Optional cleanup via `removeFiles` and post-switch `commands`
+- Config auto-discovery and type-based default `unset` keys
+
+## Quick start
+
+1) Install:
 
 ```bash
-cp code-env.example.json code-env.json
+npm install -g @praeviso/code-env-switch
 ```
 
-2) Install from npm (after publish) or locally:
+2) Add profiles interactively (this creates `~/.config/code-env/config.json` if missing):
+
+```bash
+codenv add
+# run it again to add the second type
+codenv add
+```
+
+Example session:
+
+```text
+$ codenv add
+Select type (1=codex, 2=claude): 1
+Profile name (default: default): primary
+Base URL (required): https://api.example.com/v1
+API key (required): YOUR_API_KEY
+```
+
+3) Set defaults per type:
+
+```bash
+codenv default codex primary
+codenv default claude default
+```
+
+4) Enable auto-apply in your shell:
+
+```bash
+codenv init
+```
+
+Open a new terminal (or `source ~/.bashrc` / `source ~/.zshrc`) to auto-apply the defaults.
+
+For local development install:
 
 ```bash
-npm install -g code-env-switch
-# or local dev
 npm install -g .
 # or
 npm link
@@ -22,69 +63,204 @@ npm link
 
 ## Usage
 
-List profiles:
+> By default, `codenv use` only outputs shell commands. After running
+> `codenv init`, the shell wrapper applies them automatically.
+> The snippet also wraps `codex`/`claude` to bind sessions to profiles; use
+> `command codex` / `command claude` to bypass.
+
+### Common commands
 
 ```bash
 codenv list
+codenv show codex primary
+codenv default codex primary
+codenv remove codex primary
+```
+
+`codenv list` (or `codenv ls`) prints a table with `PROFILE`, `TYPE`, and `NOTE`. Default profiles are labeled in the `NOTE` column, and the active profile is shown in green.
+If `profile.name` is set, it is shown in `PROFILE`. Otherwise the profile key is shown (with legacy `type-` prefixes stripped when possible).
+
+### Add / update a profile
+
+```bash
+codenv add primary OPENAI_BASE_URL=https://api.example.com/v1 OPENAI_API_KEY=YOUR_API_KEY --note "Primary endpoint"
+# with explicit type (codex/claude, claude also accepts cc)
+codenv add --type codex primary OPENAI_BASE_URL=https://api.example.com/v1 OPENAI_API_KEY=YOUR_API_KEY
 ```
 
-Add or update a profile from the CLI:
+When `--type` is set, the profile name is kept as-is and `type` is stored separately.
+Profiles are keyed by an internal id; the human-facing name lives in `profile.name`.
+
+Interactive add (default):
+
+```bash
+codenv add
+```
+
+### Remove a profile
 
 ```bash
-codenv add codex-88 OPENAI_BASE_URL=https://api.openai.com/v1 OPENAI_API_KEY=sk-REPLACE_ME --note "OpenAI official"
+codenv remove primary
+# or by type + name (recommended when names overlap)
+codenv remove codex primary
+# multiple at once
+codenv remove codex primary claude default
+# (legacy keys like codex-primary also work)
+codenv remove codex-primary claude-default
+# remove all
+codenv remove --all
 ```
 
-Switch in the current shell (bash/zsh):
+### Switch in the current shell (bash/zsh)
 
 ```bash
-eval "$(codenv use codex-88)"
+codenv use
+# use up/down then Enter (q to exit)
+codenv use primary
+# or by type + name (also matches legacy keys like codex-primary)
+codenv use codex primary
+codenv use cc primary
 ```
 
-Unset all known keys:
+First run `codenv init` once to install the shell wrapper:
 
 ```bash
+codenv init
+# or target a specific shell
+codenv init --shell zsh
+```
+
+This wrapper makes `codenv use` and `codenv unset` apply automatically in the
+current shell. To print the snippet without writing to rc, use
+`codenv init --print`.
+
+### Auto-apply default profiles (per type)
+
+Set a default per type (codex/claude) and re-run `codenv init`:
+
+```bash
+codenv default codex primary
+codenv default claude default
+```
+
+```json
+{
+  "defaultProfiles": {
+    "codex": "primary",
+    "claude": "default"
+  }
+}
+```
+
+On new terminal sessions, `codenv` will auto-apply all defaults via `codenv auto`.
+To clear all defaults, run `codenv default --clear` (with confirmation).
+
+One-off without init:
+
+```bash
+eval "$(codenv use codex primary)"
+```
+
+Note: the change takes effect in new terminals. To apply immediately, run:
+
+```bash
+source ~/.bashrc
+# or for zsh
+source ~/.zshrc
+```
+
+### Unset known keys
+
+```bash
+codenv unset
+# or one-off without init
 eval "$(codenv unset)"
 ```
 
-### Config lookup order
+### Fish shell
+
+```fish
+codenv use codex primary
+# or one-off without init
+codenv use codex primary | source
+```
+
+## Config lookup order
 
 `codenv` searches in this order:
 
 1) `--config <path>`
 2) `CODE_ENV_CONFIG`
-3) `./code-env.json`
-4) `./profiles.json`
-5) `./code-env.config.json`
-6) `~/.config/code-env/config.json`
+3) `~/.config/code-env/config.json`
+
+Use `codenv config` to print the path selected for the current directory.
+
+If nothing is found, `codenv add` writes to `~/.config/code-env/config.json`.
 
 ## Config format
 
 ```json
 {
-  "unset": ["OPENAI_BASE_URL", "OPENAI_API_KEY"],
+  "unset": [],
+  "defaultProfiles": {
+    "codex": "primary",
+    "claude": "default"
+  },
+  "codexStatusline": {
+    "command": ["codenv", "statusline", "--type", "codex", "--sync-usage"],
+    "showHints": false,
+    "updateIntervalMs": 300,
+    "timeoutMs": 1000
+  },
+  "claudeStatusline": {
+    "command": "codenv statusline --type claude --sync-usage",
+    "type": "command",
+    "padding": 0
+  },
   "profiles": {
-    "codex-88": {
-      "note": "OpenAI official",
+    "p_a1b2c3": {
+      "name": "primary",
+      "type": "codex",
+      "note": "Primary endpoint",
       "env": {
-        "OPENAI_BASE_URL": "https://api.openai.com/v1",
-        "OPENAI_API_KEY": "sk-REPLACE_ME",
-        "CODEX_PROVIDER": "OpenAI"
+        "OPENAI_BASE_URL": "https://api.example.com/v1",
+        "OPENAI_API_KEY": "YOUR_API_KEY"
       },
-      "removeFiles": ["$HOME/.config/openai/auth.json"],
-      "commands": ["echo \"Switched to codex-88\""]
+      "removeFiles": ["$HOME/.config/example/auth.json"],
+      "commands": ["echo \"Switched to codex primary\""]
     }
   }
 }
 ```
 
 Notes:
-- `removeFiles` is optional; when present, `codenv use <profile>` emits `rm -f` lines for those paths.
-- `commands` is optional; any strings are emitted as-is.
-- `note` is shown in `codenv list` output.
-- `codenv add` creates the config file if it does not exist (default: `./code-env.json`).
+- `unset`: global keys to clear. Type-specific defaults are applied only for the active type and won't clear the other type.
+- `defaultProfiles`: optional; map of `codex`/`claude` to profile name or key used by `codenv auto`.
+- `codexStatusline`: optional; config to inject Codex TUI status line settings when launching `codex`.
+  - `command`: string or string[]; command passed to Codex `tui.status_line.command`.
+  - `showHints`: boolean; whether Codex footer hints are appended when the status line is active.
+  - `updateIntervalMs`: number; update interval in ms for the status line command.
+  - `timeoutMs`: number; timeout in ms for the status line command.
+  - `configPath`: optional; override `~/.codex/config.toml` (also supports `CODE_ENV_CODEX_CONFIG_PATH`).
+- `claudeStatusline`: optional; config to inject Claude Code statusLine settings when launching `claude`.
+  - `command`: string (or string[]; arrays are joined into a single command string).
+  - `type`: string; statusLine type (default: `command`).
+  - `padding`: number; statusLine padding (default: 0).
+  - `settingsPath`: optional; override `~/.claude/settings.json` (also supports `CODE_ENV_CLAUDE_SETTINGS_PATH`).
+- `name`: human-facing profile name shown in `codenv list` and used by `codenv use <name>`.
+- `type`: optional; `codex` or `claude` (alias `cc`) for `codenv use <type> <name>` matching.
+- `note`: shown in `codenv list`.
+- `removeFiles`: optional; `codenv use` emits `rm -f` for each path. Codex profiles also remove `~/.codex/auth.json`.
+- `ANTHROPIC_AUTH_TOKEN`: when `ANTHROPIC_API_KEY` is set, `codenv use` also exports `ANTHROPIC_AUTH_TOKEN` with the same value.
+- `commands`: optional; emitted as-is in the switch script.
 
-## Fish shell
+## Security
 
-```fish
-codenv use codex-88 | source
+Your config contains API keys. Keep it private and out of public repositories.
+
+## Development
+
+```bash
+npm install
+npm run build
 ```