Merge pull request #6 from comet-ml/feat/opik-cc-workspace-override

feat: plugin-scoped workspace & project overrides (cc_workspace / cc_project)

Author: jverre

README.md

@@ -57,11 +57,28 @@ This creates `~/.opik.config` with your API URL, key, and workspace.
 
 ```bash
 export OPIK_CC_PROJECT="my-project"         # Project name (default: claude-code)
+export OPIK_CC_WORKSPACE="my-workspace"     # Workspace override (default: OPIK_WORKSPACE / ~/.opik.config)
 export OPIK_CC_TRUNCATE_FIELDS="false"      # Don't truncate large fields
 ```
 
 All plugin env vars use the `OPIK_CC_` prefix to avoid conflicts with standard Opik SDK variables.
 
+`OPIK_CC_WORKSPACE` and `OPIK_CC_PROJECT` let you send Claude Code traces to a different
+workspace/project than the rest of your Opik setup, without touching the global
+`OPIK_WORKSPACE` / `project_name` in `~/.opik.config` used by the Opik SDK. Both can also be
+set in `~/.opik.config` via the plugin-scoped `cc_workspace` and `cc_project` keys:
+
+```ini
+[opik]
+workspace = my-sdk-workspace      # used by the Opik SDK
+project_name = my-sdk-project     # used by the Opik SDK
+cc_workspace = my-cc-workspace        # used only by the Claude Code plugin
+cc_project_name = my-cc-project       # used only by the Claude Code plugin
+```
+
+> Note: for backward compatibility, if `cc_project_name` is not set the plugin still falls back
+> to the shared `project_name` key.
+
 ### External Trace Linking
 
 Link Claude Code sessions to existing Opik traces (useful for embedding Claude Code in larger workflows):

src/config.go

@@ -47,8 +47,19 @@ func LoadConfig() (*Config, error) {
 		RootSpanID:    os.Getenv("OPIK_CC_ROOT_SPAN_ID"),
 	}
 
-	if proj := getEnvOrConfig("OPIK_CC_PROJECT", fileConfig, "project_name"); proj != "" {
+	// OPIK_CC_PROJECT / cc_project are plugin-scoped and don't affect the Opik
+	// SDK. project_name is kept as a fallback for backward compatibility, but it
+	// is shared with the Opik SDK config in ~/.opik.config.
+	if proj := getEnvOrConfig("OPIK_CC_PROJECT", fileConfig, "cc_project_name"); proj != "" {
 		cfg.Project = proj
+	} else if proj := fileConfig["project_name"]; proj != "" {
+		cfg.Project = proj
+	}
+
+	// Allow overriding the workspace for the Claude Code plugin only, without
+	// affecting the global OPIK_WORKSPACE / ~/.opik.config used by the Opik SDK.
+	if ws := getEnvOrConfig("OPIK_CC_WORKSPACE", fileConfig, "cc_workspace"); ws != "" {
+		cfg.Workspace = ws
 	}
 
 	return cfg, nil