dsh-codex-tools

中文

A DeepSeek Harness plugin that registers three tools provided by ChatGPT Codex:

It consumes an existing Codex/ChatGPT login; it does not provide login or an LLM provider.

Runtime requirements

• DeepSeek Harness.
• A ChatGPT/Codex login state, either codex login with an auth file, or credentials in DSH:
  • OPENAI_CODEX_API_KEY
  • OPENAI_CODEX_REFRESH_TOKEN

Credentials are resolved from CODEX_ACCESS_TOKEN and CODEX_REFRESH_TOKEN environment variables first (the plugin maps the DSH credential names above to these variables). If those are absent, the transport reads $CODEX_HOME/auth.json when CODEX_HOME is set, or ~/.codex/auth.json otherwise. Set CODEX_HOME to choose another auth directory; the default is ~/.codex. After an HTTP 401, a transport refreshes the access token once and attempts to persist the refreshed login state to that auth file. When the plugin injects DSH credentials, the refresh code may still write to the auth file selected by CODEX_HOME or the default path.

Installation

# Git
dsh plugin --profile web add github:SPYQWER1/dsh-codex-tools

# npm
dsh plugin --profile web add dsh-codex-tools

Restart after installation (dsh web or dsh --profile web). Remove it with dsh plugin --profile web remove dsh-codex-tools.

Screenshots

Image generation

Image vision

Tool parameters

codex_web_search

The result contains summary and sources; each source has a title, URL, and snippet.

image_gen

image_vision

The transport reads the local file, embeds it in the request, and sends it to the ChatGPT Codex endpoint. Only files inside the transport workspace are accepted.

Architecture

Harness model tool
        |
        v
index.js -> tools.js -> scripts/codex-*.mjs
                              |
                              +-- OAuth refresh (auth.openai.com)
                              +-- POST chatgpt.com/backend-api/codex/responses
                              |
             codex_web_search: gpt-5.4-mini by default
             image_gen / image_vision: gpt-5.5 by default

Caveats and service terms

• chatgpt.com/backend-api/codex/responses is an internal endpoint used by the official Codex CLI, not a documented public API. It may change or be restricted without notice.
• Search summaries and snippets are model-generated; open the returned source URLs and check the original text before relying on them.
• Web search and image generation use the metered Codex-usage bucket of the ChatGPT plan.
• Follow OpenAI's Terms of Use; do not use a ChatGPT subscription to power a public-facing image-generation service.

License

MIT — see LICENSE.