dsh-codex-tools DSH plugin

This plugin for DeepSeek Harness provides three tools: web_search, image_gen, and image_vision, all backed by the ChatGPT Codex transport. It uses Node.js built-in https and requires an existing ChatGPT/Codex login. The tools enable web research, image creation, and image understanding within DSH sessions.

vision browser-web

How to install the dsh-codex-tools DSH plugin

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

Copying does not run this command. Review the repository and version before installing the dsh-codex-tools DSH plugin.

dsh-codex-tools DSH plugin data source

dsh-codex-tools DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-codex-tools DSH plugin can do

`web_search` searches the public web and returns a summary with source URLs
`image_gen` generates a new bitmap image from a text prompt (does not edit existing images)
`image_vision` reads a local image and returns a description or answers a question about it
Supports configurable models per tool (e.g., gpt-5.4-mini for search, gpt-5.5 for image tasks)
OAuth refresh mechanism: automatically refreshes access tokens on 401 and persists the new state

Where the dsh-codex-tools DSH plugin fits

Search the web for current information and get a summarised result with sources
Generate images from text descriptions for creative or prototyping purposes
Describe the content of an image or ask specific questions about it
Integrate web search and image capabilities into DSH-powered workflows
Automate image description tasks for accessibility or logging

Who the dsh-codex-tools DSH plugin is for

DSH users who need web search, image generation, or image analysis inside their sessions
Developers building AI-assisted workflows that require these capabilities via model tools

dsh-codex-tools DSH plugin limitations

Requires an existing ChatGPT/Codex login (credentials or auth file); does not provide login
Uses an internal, undocumented endpoint (`chatgpt.com/backend-api/codex/responses`) that may change or be restricted
`image_gen` and `image_vision` only accept workspace-relative paths; absolute paths, parent-directory segments, and symlinks are rejected
Image generation never overwrites existing files and does not support transparent backgrounds
Web search and image generation consume the metered Codex-usage bucket of the ChatGPT plan

dsh-codex-tools DSH plugin: from the repository README

Quoted from the SPYQWER1/dsh-codex-tools README, the upstream source of the dsh-codex-tools DSH plugin. Copyright remains with the original authors.

A DeepSeek Harness plugin that registers three model tools backed by the ChatGPT Codex transport: | Tool | Function | | --- | --- | | `web_search` | Searches the public web and returns a summary with source URLs. | | `image_gen` | Generates a bitmap image. It does not edit or transform an existing image. | | `image_vision` | Reads a local image and returns a description or an answer to a question about it. | The package has no npm runtime dependencies and uses Node's built-in `https` transport. It consumes an existing Codex/ChatGPT login; it does not provide login or an LLM provider. ## Runtime requirements - DeepSeek Harness, with the plugin installed as a profile-level Cordis bundle. - Node.js >= 22. - 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 an

Read the full READMERepository license: MIT

dsh-codex-tools DSH plugin questions

How do I install dsh-codex-tools?

You can install it via Git: `dsh plugin --profile web add github:SPYQWER1/dsh-codex-tools`. Alternatively, download a tarball and use `dsh plugin --profile web add ./dsh-codex-tools-1.0.0.tgz`. After installation, restart the profile with `dsh web` or `dsh --profile web`.

What credentials do I need to use the plugin?

You need a ChatGPT/Codex login state. The plugin uses either `CODEX_ACCESS_TOKEN` and `CODEX_REFRESH_TOKEN` environment variables, or a Codex auth file at `$CODEX_HOME/auth.json` (default `~/.codex/auth.json`). You can also set `OPENAI_CODEX_API_KEY` and `OPENAI_CODEX_REFRESH_TOKEN` in DSH credential configuration.

Can I use image_gen with transparent backgrounds?

No, transparent-background output is not supported. The documentation suggests requesting a solid or chroma-key background and removing it locally if needed.

What image formats are supported for image_vision?

image_vision accepts PNG, JPEG/JPG, WebP, and GIF files. The image must be under 15 MiB and located inside the transport workspace. Absolute paths, parent-directory segments, and symbolic links are rejected.

Does the plugin work without a ChatGPT subscription?

No, the plugin requires a ChatGPT plan that includes Codex usage. Web search and image generation consume the metered Codex-usage bucket. You must have valid Codex credentials.