Spreadsheet primary runtime is installed, but JS REPL and load_workspace_dependencies are not exposed to Codex sessions on macOS
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
What version of Codex CLI is running?
codex-cli 0.152.1
What subscription do you have?
ChatGPT Plus
Which model were you using?
No response
What platform is your computer?
No response
What terminal emulator and version are you using (if applicable)?
No response
Codex doctor report
What issue are you seeing?
The Spreadsheet primary runtime is installed locally and @oai/artifact-tool is present and functional, but new Codex CLI sessions do not expose the JS REPL or load_workspace_dependencies.
Environment:
- macOS Apple Silicon
- Codex CLI 0.152.1
- Installed via Homebrew
- Started from a PyCharm project terminal
- spreadsheets@openai-primary-runtime is enabled
- js_repl = true
The primary runtime exists at:
~/.cache/codex-runtimes/codex-primary-runtime/
@oai/artifact-tool 2.8.52 exists at:
~/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/node_modules/@oai/artifact-tool
I verified that the package itself works by importing it directly with the Node executable bundled in the primary runtime. That test succeeds and returns the artifact-tool exports.
However, after completely terminating Codex and starting a new session:
- JS REPL is not available to the session.
- load_workspace_dependencies is not available as a global function or exposed tool.
- @oai/artifact-tool therefore cannot be loaded through the expected Spreadsheet runtime workflow.
This prevents Spreadsheet editing/final QA using the official OpenAI Spreadsheet primary runtime.
The runtime files and artifact-tool package appear healthy. The issue appears to be that the required runtime/tooling is not being provisioned or exposed to the Codex session.
What steps can reproduce the bug?
-
Install/run Codex CLI on macOS Apple Silicon using Homebrew.
-
Confirm:
codex --version
Result: codex-cli 0.152.1 -
Enable JS REPL in ~/.codex/config.toml:
[features]
js_repl = true -
Confirm spreadsheets@openai-primary-runtime is installed/enabled.
-
Confirm the primary runtime exists at:
~/.cache/codex-runtimes/codex-primary-runtime/ -
Confirm @oai/artifact-tool exists at:
~/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/node_modules/@oai/artifact-tool -
Test artifact-tool directly:
cd "$HOME/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/node_modules"
"$HOME/.cache/codex-runtimes/codex-primary-runtime/dependencies/node/bin/node"
-e "import('@oai/artifact-tool').then(m => { console.log('OK: artifact-tool loaded'); console.log(Object.keys(m).slice(0,20)); }).catch(e => { console.error(e); process.exit(1); })" -
The direct import succeeds:
OK: artifact-tool loaded -
Completely terminate the Codex session.
-
Start a new Codex session from the project root.
-
Ask Codex to verify:
- whether JS REPL is available
- whether @oai/artifact-tool can be imported
- whether load_workspace_dependencies is available
-
Actual result:
- JS REPL unavailable
- load_workspace_dependencies unavailable
- Spreadsheet runtime workflow cannot proceed
Expected:
A new Codex session should expose the required JS REPL/dependency-loader functionality when the Spreadsheet primary runtime is installed and enabled.
What is the expected behavior?
No response
Additional information
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the session behavior using ~/.codex/config.toml, the codex-primary-runtime path, and the listed js_repl configuration. Verify whether the new session initializes the JS REPL and exposes load_workspace_dependencies despite the successful direct @oai/artifact-tool import. Done means the expected Spreadsheet runtime functionality is available after restarting Codex.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript, macos, node.js, rust
- Domain
- cli, developer-experience, tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 52/100