@heungtae/codex-chat-bridge 0.1.0 → 0.1.1

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
@@ -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:

package/USAGE.md

@@ -60,8 +60,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 +79,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`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heungtae/codex-chat-bridge",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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/src/main.rs

@@ -41,8 +41,12 @@ use uuid::Uuid;
     about = "Responses-to-Chat completions bridge"
 )]
 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 +87,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 +204,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 +261,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 +1164,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 +1196,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 +1216,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