devteapot/dsh-openai-codex
An OpenAI Codex provider adapter for DeepSeek Harness. The package root exposes the Cordis plugin contract plus OpenAiCodexAdapter, OpenAiCodexAuth (as ctx.openaiCodex), createCodexModels and the OAuth store helpers. The README documents configuration (static and dynamic), an errors section, and a detailed "model experience" walkthrough covering how a provider request is converted for the model (token effect and KV-cache effect: conversion adds no model-visible text and preserves request order, but changing the adapter instance, provider, model or any upstream request token can prevent cache reuse from the first difference) and how responses come back. It also lists known limitations and deferred work.
Install
dsh plugin --profile web add github:devteapot/dsh-openai-codexREADME install, quoted verbatim: dsh plugin --profile web add github:devteapot/dsh-openai-codex#<commit> — the README asks you to pin a commit hash for this development release. Built artifacts are committed, so a Git-hash install runs no package build, and Harness/pi-ai packages are declared as peers resolved through the profile's installation fallback (the profile does not install a second provider SDK tree). The package declares dsh.bundle, so dsh plugin add tracks it in the profile. The README states it requires DeepSeek Harness 0.1.0-rc.6 or newer. The npm name dsh-openai-codex 0.1.0 exists with no repository field (registry-verified 2026-09-12) and is not claimed here.
Compatibility
DeepSeek Harness web profile, version 0.1.0-rc.6 or newer. Harness and pi-ai packages are peers resolved through the profile's installation fallback, so no second provider SDK tree is installed; the conversion layer carries its own pi-ai history and event conversion, so a Git install does not depend on an unpublished harness export.
Details
- Repo: devteapot/dsh-openai-codex
- Category: Coding & Development
- Stars: 0
- Version: GitHub development release for DeepSeek Harness 0.1.0-rc.6+ (README documents a #<commit> pin; no npm release claimed)
- Last push: 2026-08-13
- First seen: 2026-08-13
Recent updates
The README documents the adapter contract rather than a release history: the exported API surface, static vs dynamic configuration, an errors section, and per-request token/KV-cache notes (including that passing GenerateOptions.sessionId lets pi-ai's Codex path reuse a session cache unless cache retention is disabled). It also carries a known-limitations and deferred-work section and asks for a commit-hash pin in the install spec.
FAQ
- How do I install the Codex provider?
- dsh plugin --profile web add github:devteapot/dsh-openai-codex#<commit> — the README's form, pinned to a commit hash. It requires DeepSeek Harness 0.1.0-rc.6 or newer.
- Does a Git install need a build step?
- No — the README states built artifacts are committed, so installing by Git hash runs no package build; Harness and pi-ai are peers resolved via the profile's installation fallback.
- Does the adapter hurt prompt caching?
- The README's KV-cache note says conversion adds no model-visible text and preserves logical request order, but changing the adapter instance, provider, model or any upstream request token can prevent reuse from the first difference.
Alternatives
nexu-io/open-design · dsh-market/dsh-market · xiufengsun/TokenTracker