Convert project-scoped Claude Code workspace files into Codex CLI-compatible project files.
Project description
codex-converter
Convert project-scoped Claude Code workspace files into Codex CLI-compatible project files.
codex-converter is intentionally conservative. It reads only project-local Claude assets and rejects user-scoped Claude paths such as ~/.claude.
Install
Install with uv.
uv tool install codex-converter
You can also run it without a persistent install:
uvx codex-converter --help
Usage
Inspect a project without writing files:
codex-converter inspect /path/to/project
Preview a conversion:
codex-converter convert /path/to/project --dry-run
Convert in place:
codex-converter convert /path/to/project
Write converted files to a separate directory:
codex-converter convert /path/to/project --output /path/to/output
Overwrite previously generated targets:
codex-converter convert /path/to/project --force
Add generated Codex output paths to the output project's .gitignore:
codex-converter convert /path/to/project --gitignore
Remove generated converter output:
codex-converter clean /path/to/project
Preview cleanup first:
codex-converter clean /path/to/project --dry-run
Show the installed version:
codex-converter --version
What Gets Converted
| Claude Code input | Codex output |
|---|---|
CLAUDE.md |
AGENTS.md |
nested CLAUDE.md files |
nested AGENTS.md files |
.claude/skills/<name>/ |
.agents/skills/<name>/ |
.claude/commands/<name>.md |
.agents/skills/<name>/SKILL.md |
.claude/agents/<name>.md |
.codex/agents/<name>.toml |
.claude/settings.json |
.codex/config.toml |
.claude/settings.local.json |
merged into .codex/config.toml only with --include-local-settings |
Existing targets are reported as conflicts and left untouched unless --force is used. --dry-run reports planned writes without creating files.
clean removes only files or directories that contain, or can be verified from, a codex-converter generated marker. clean --force removes known generated target paths even when a marker is missing.
Unsupported
The converter reports but does not convert:
- Claude hooks
- MCP server configuration
- plugins and marketplace configuration
- auth and trust configuration
- unsupported Claude settings
- user-scoped Claude assets under
~/.claude
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file codex_converter-0.1.2.tar.gz.
File metadata
- Download URL: codex_converter-0.1.2.tar.gz
- Upload date:
- Size: 48.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6335538f44690f62aca0dce88cf12a6ce3c4c4e403bd6c56a1db2e385a767357
|
|
| MD5 |
ab9f59f7312d0288b8601c3b3c3a228d
|
|
| BLAKE2b-256 |
c6940f81cee786cdb18c532e40b4b329c0d734c0fac0fa6c2f56d10db63e64c0
|
Provenance
The following attestation bundles were made for codex_converter-0.1.2.tar.gz:
Publisher:
release.yml on rainbowhunter-nz/codex-converter
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
codex_converter-0.1.2.tar.gz -
Subject digest:
6335538f44690f62aca0dce88cf12a6ce3c4c4e403bd6c56a1db2e385a767357 - Sigstore transparency entry: 1595650337
- Sigstore integration time:
-
Permalink:
rainbowhunter-nz/codex-converter@7385e14e0dd40b53ca4e2fe30d8bc869fb2e2c1b -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/rainbowhunter-nz
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7385e14e0dd40b53ca4e2fe30d8bc869fb2e2c1b -
Trigger Event:
push
-
Statement type:
File details
Details for the file codex_converter-0.1.2-py3-none-any.whl.
File metadata
- Download URL: codex_converter-0.1.2-py3-none-any.whl
- Upload date:
- Size: 11.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
23f7969eb223303e35514e8f6739ab75ce7de3cf2fd72c0124cca994f25b4a23
|
|
| MD5 |
f6277174677572dcfb7e03d682991a80
|
|
| BLAKE2b-256 |
7090a98a94e985c1914594d9f52be44b3b0b2f3d46be31601c8a737283cff022
|
Provenance
The following attestation bundles were made for codex_converter-0.1.2-py3-none-any.whl:
Publisher:
release.yml on rainbowhunter-nz/codex-converter
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
codex_converter-0.1.2-py3-none-any.whl -
Subject digest:
23f7969eb223303e35514e8f6739ab75ce7de3cf2fd72c0124cca994f25b4a23 - Sigstore transparency entry: 1595650359
- Sigstore integration time:
-
Permalink:
rainbowhunter-nz/codex-converter@7385e14e0dd40b53ca4e2fe30d8bc869fb2e2c1b -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/rainbowhunter-nz
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7385e14e0dd40b53ca4e2fe30d8bc869fb2e2c1b -
Trigger Event:
push
-
Statement type:
