@heungtae/codex-chat-bridge 0.1.0 → 0.1.2

package/README.md

@@ -14,11 +14,10 @@ Node.js 20+ and Rust/Cargo are required because npm installation compiles the Ru
 npm install @heungtae/codex-chat-bridge
 ```
 
-Private registry publish/install is also supported:
+Install globally if you want the `codex-chat-bridge` command on PATH:
 
 ```bash
-npm publish --registry <private-registry> --access restricted
-npm install @heungtae/codex-chat-bridge --registry <private-registry>
+npm install -g @heungtae/codex-chat-bridge
 ```
 
 ## What it does
@@ -27,7 +26,7 @@ npm install @heungtae/codex-chat-bridge --registry <private-registry>
 - Translates request payload into `POST /v1/chat/completions`
 - Streams upstream Chat Completions chunks back as Responses-style SSE events:
   - `response.created`
-  - `response.output_item.added` (assistant message start)
+  - `response.output_item.added` (assistant text starts; only emitted when text delta exists)
   - `response.output_text.delta`
   - `response.output_item.done` (assistant message and function calls)
   - `response.completed`
@@ -39,7 +38,8 @@ npm install @heungtae/codex-chat-bridge --registry <private-registry>
 npx @heungtae/codex-chat-bridge --port 8787 --api-key-env OPENAI_API_KEY
 ```
 
-By default, the bridge also reads `conf.toml` in the current directory.
+By default, the bridge uses `~/.config/codex-chat-bridge/conf.toml`.
+If the file does not exist, it is created automatically with commented defaults.
 CLI flags override file values.
 
 Or run the binary directly via Cargo:
@@ -73,6 +73,11 @@ Use `scripts/run_codex_with_bridge.sh` to run the bridge and `codex exec` togeth
 scripts/run_codex_with_bridge.sh "Summarize this repo."
 ```
 
+Defaults:
+- `API_KEY_ENV=OPENAI_API_KEY`
+- `UPSTREAM_URL=https://api.openai.com/v1/chat/completions`
+- The script does not force `model`; pass it as extra args when needed (for example: `--model gpt-4.1`).
+
 ## Package Scripts
 
 ```bash

package/USAGE.md

@@ -9,7 +9,13 @@ npm install @heungtae/codex-chat-bridge
 npx @heungtae/codex-chat-bridge --help
 ```
 
-private registry 배포:
+공개 npm 배포(현재 기본값):
+
+```bash
+npm publish --access public
+```
+
+private registry 배포(선택):
 
 ```bash
 npm publish --registry <private-registry> --access restricted
@@ -60,8 +66,9 @@ npx @heungtae/codex-chat-bridge -- \
   --api-key-env OPENAI_API_KEY
 ```
 
-기본적으로 현재 디렉터리의 `conf.toml`을 자동으로 읽습니다.
-우선순위는 `CLI 옵션 > conf.toml > 내장 기본값`입니다.
+기본적으로 `~/.config/codex-chat-bridge/conf.toml`을 사용합니다.
+파일이 없으면 기본 템플릿으로 자동 생성됩니다.
+우선순위는 `CLI 옵션 > 설정 파일 > 내장 기본값`입니다.
 
 또는 Cargo 직접 실행:
 
@@ -78,7 +85,7 @@ npx @heungtae/codex-chat-bridge --config /path/to/conf.toml
 ```
 
 옵션 설명:
-- `--config <FILE>`: 설정 파일 경로 (기본값: `conf.toml`)
+- `--config <FILE>`: 설정 파일 경로 (기본값: `~/.config/codex-chat-bridge/conf.toml`)
 - `--port`: 브리지 포트 (기본: 랜덤 포트)
 - `--api-key-env`: 업스트림 호출에 쓸 API 키 환경변수 이름
 - `--upstream-url`: 기본값 `https://api.openai.com/v1/chat/completions`
@@ -133,6 +140,11 @@ codex exec '간단한 테스트를 해줘'
 scripts/run_codex_with_bridge.sh "이 저장소 구조를 설명해줘"
 ```
 
+기본값:
+- `API_KEY_ENV=OPENAI_API_KEY`
+- `UPSTREAM_URL=https://api.openai.com/v1/chat/completions`
+- 래퍼 스크립트는 `model`을 강제하지 않음 (필요 시 추가 인자로 전달)
+
 추가 인자 전달:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heungtae/codex-chat-bridge",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Responses-to-chat/completions bridge for Codex workflows",
   "license": "Apache-2.0",
   "type": "commonjs",
@@ -11,13 +11,12 @@
     "node": ">=20"
   },
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "files": [
     "bin/",
     "scripts/",
     "src/",
-    "conf.toml",
     "Cargo.toml",
     "Cargo.lock",
     "README.md",

package/scripts/run_codex_with_bridge.sh

@@ -9,8 +9,8 @@ fi
 PROMPT="$1"
 shift || true
 
-API_KEY_ENV="${API_KEY_ENV:-OPENROUTER_API_KEY}"
-UPSTREAM_URL="${UPSTREAM_URL:-https://openrouter.ai/api/v1/chat/completions}"
+API_KEY_ENV="${API_KEY_ENV:-OPENAI_API_KEY}"
+UPSTREAM_URL="${UPSTREAM_URL:-https://api.openai.com/v1/chat/completions}"
 BRIDGE_PORT="${BRIDGE_PORT:-8787}"
 SERVER_INFO="${SERVER_INFO:-/tmp/codex-chat-bridge-info.json}"
 CODEX_BRIDGE_RUST_LOG="${CODEX_BRIDGE_RUST_LOG:-${RUST_LOG:-info,codex_core::rollout::list=off}}"
@@ -42,6 +42,4 @@ done
 RUST_LOG="${CODEX_BRIDGE_RUST_LOG}" codex exec \
   -c "model_providers.chat-bridge={name='Chat Bridge',base_url='http://127.0.0.1:${BRIDGE_PORT}/v1',env_key='${API_KEY_ENV}',wire_api='responses'}" \
   -c 'model_provider="chat-bridge"' \
-  -c 'model="arcee-ai/trinity-large-preview:free"' \
-  -c 'web_search="disabled"' \
   "$PROMPT" "$@"

package/src/main.rs

@@ -38,11 +38,16 @@ use uuid::Uuid;
 #[derive(Debug, Clone, Parser)]
 #[command(
     name = "codex-chat-bridge",
-    about = "Responses-to-Chat completions bridge"
+    about = "Responses-to-Chat completions bridge",
+    version
 )]
 struct Args {
-    #[arg(long, value_name = "FILE", default_value = "conf.toml")]
-    config: PathBuf,
+    #[arg(
+        long,
+        value_name = "FILE",
+        help = "config file path (default: ~/.config/codex-chat-bridge/conf.toml)"
+    )]
+    config: Option<PathBuf>,
 
     #[arg(long)]
     host: Option<String>,
@@ -83,6 +88,18 @@ struct ResolvedConfig {
     http_shutdown: bool,
 }
 
+const DEFAULT_CONFIG_TEMPLATE: &str = r#"# codex-chat-bridge runtime configuration
+#
+# Priority: CLI flags > config file > built-in defaults
+
+# host = "127.0.0.1"
+# port = 8787
+# upstream_url = "https://api.openai.com/v1/chat/completions"
+# api_key_env = "OPENAI_API_KEY"
+# server_info = "/tmp/codex-chat-bridge-info.json"
+# http_shutdown = false
+"#;
+
 #[derive(Clone)]
 struct AppState {
     client: Client,
@@ -188,7 +205,9 @@ async fn main() -> Result<()> {
         .init();
 
     let args = Args::parse();
-    let file_config = load_file_config(&args.config)?;
+    let config_path = resolve_config_path(args.config.clone())?;
+    ensure_default_config_file(&config_path)?;
+    let file_config = load_file_config(&config_path)?;
     let config = resolve_config(args, file_config);
 
     let api_key = std::env::var(&config.api_key_env)
@@ -243,6 +262,35 @@ fn load_file_config(path: &Path) -> Result<Option<FileConfig>> {
     Ok(Some(parsed))
 }
 
+fn resolve_config_path(cli_path: Option<PathBuf>) -> Result<PathBuf> {
+    if let Some(path) = cli_path {
+        return Ok(path);
+    }
+
+    let home = std::env::var_os("HOME")
+        .ok_or_else(|| anyhow!("HOME environment variable is not set"))?;
+    Ok(PathBuf::from(home)
+        .join(".config")
+        .join("codex-chat-bridge")
+        .join("conf.toml"))
+}
+
+fn ensure_default_config_file(path: &Path) -> Result<()> {
+    if path.exists() {
+        return Ok(());
+    }
+
+    if let Some(parent) = path.parent() {
+        fs::create_dir_all(parent)
+            .with_context(|| format!("creating config directory {}", parent.display()))?;
+    }
+
+    fs::write(path, DEFAULT_CONFIG_TEMPLATE)
+        .with_context(|| format!("creating default config file {}", path.display()))?;
+    info!("created default config file {}", path.display());
+    Ok(())
+}
+
 fn resolve_config(args: Args, file_config: Option<FileConfig>) -> ResolvedConfig {
     let file_config = file_config.unwrap_or_default();
 
@@ -1117,7 +1165,7 @@ mod tests {
     #[test]
     fn resolve_config_prefers_cli_over_file_and_defaults() {
         let args = Args {
-            config: PathBuf::from("conf.toml"),
+            config: None,
             host: Some("0.0.0.0".to_string()),
             port: Some(9999),
             upstream_url: None,
@@ -1149,7 +1197,7 @@ mod tests {
     #[test]
     fn resolve_config_uses_defaults_when_missing() {
         let args = Args {
-            config: PathBuf::from("conf.toml"),
+            config: None,
             host: None,
             port: None,
             upstream_url: None,
@@ -1169,4 +1217,10 @@ mod tests {
         assert_eq!(resolved.server_info, None);
         assert!(!resolved.http_shutdown);
     }
+
+    #[test]
+    fn resolve_config_path_prefers_cli_value() {
+        let path = resolve_config_path(Some(PathBuf::from("/tmp/custom.toml"))).expect("ok");
+        assert_eq!(path, PathBuf::from("/tmp/custom.toml"));
+    }
 }

package/conf.toml

@@ -1,10 +0,0 @@
-# codex-chat-bridge runtime configuration
-#
-# Priority: CLI flags > conf.toml > built-in defaults
-
-# host = "127.0.0.1"
-# port = 8787
-# upstream_url = "https://api.openai.com/v1/chat/completions"
-# api_key_env = "OPENAI_API_KEY"
-# server_info = "/tmp/codex-chat-bridge-info.json"
-# http_shutdown = false