codexospackage
v0.0.2
Published
Codex-OS npm wrapper for installing and running the Codex-native workflow system from a cloned repository.
Maintainers
Readme
codexospackage
npm package wrapper for installing and running Codex-OS.
Keywords
codex, codex-os, ai-workflow, cli, developer-tools, agentic
License
MIT
What This Package Does
- exposes
codexoscommand - on
npm install -g, auto-bootstraps by cloninghttps://github.com/rotsl/codex-osto~/.codex/codex-os(if missing) - runs Codex-OS
install.shautomatically during package postinstall - proxies
rocommand after setup - proxies
ro-claudecommand after setup - provides
doctorcheck for repo,ro,ro-claude, andcodexshim
Install
Global install (auto bootstrap):
npm install -g ./codexospackageThis postinstall path stays non-interactive and uses the systemwide install flow automatically so global npm installs do not hang on the new scope prompt.
If you want to skip auto bootstrap during install:
CODEXOS_SKIP_POSTINSTALL=1 npm install -g ./codexospackageRun
Install/repair wiring manually:
codexos installThe installer will ask whether the setup is for this repo only or systemwide.
If you choose systemwide, it will show backup and restore commands and proceed only after you type Accept.
Install/repair Claude wiring manually:
codexos install-claudeUse a specific local clone:
codexos install --repo /absolute/path/to/codex-osRun a task:
codexos ro "build login API"Run a Claude task:
codexos claude --memory-mode auto "review this project"Check setup:
codexos doctorEquivalent Coverage
After bootstrap, behavior matches the main repository workflow:
- terminal usage
- terminal with venv
- VS Code terminal
- VS Code terminal with venv
- Codex chat-mode wiring through AGENTS autoload
