What's New
OpenAI Codex Support
Autoresearch now runs on three platforms: Claude Code, OpenCode, and OpenAI Codex.
Codex-specific:
- Skills installed to
.agents/skills/autoresearch/(Codex standard path) - Invoked via
$autoresearchmention syntax (not slash commands) - Subcommands are keywords:
$autoresearch plan,$autoresearch debug,$autoresearch security, etc. - Includes
agents/openai.yamlfor Codex UI metadata (display name, brand color, implicit invocation) - Global install path:
~/.agents/skills/(or$CODEX_HOME/skills/)
New Files
| File | Purpose |
|---|---|
.agents/skills/autoresearch/SKILL.md
| Codex-adapted skill (726 lines) |
.agents/skills/autoresearch/references/*.md
| 12 workflow protocol files |
.agents/skills/autoresearch/agents/openai.yaml
| Codex UI metadata |
scripts/sync-codex.sh
| Sync .claude/ → .agents/ with Codex adaptations
|
Updated Files
scripts/install.sh— added--codexflag, Codex install paths, interactive Codex optionREADME.md— Codex badge, quick start, repo structure, FAQ entry, creditsCONTRIBUTING.md— Codex development workflow, updated repo structureguide/getting-started.md— Codex installation section, updated verification
Installation
# Guided installer
./scripts/install.sh --codex --global
# Manual
cp -r .agents/skills/autoresearch ~/.agents/skills/autoresearchKey Adaptations from Claude Code → Codex
| Claude Code | Codex |
|---|---|
/autoresearch:plan
| $autoresearch plan
|
AskUserQuestion
| Direct prompting |
Agent tool
| Codex subagent |
.claude/skills/
| .agents/skills/
|
version: frontmatter
| metadata: block
|
Testing Checklist
- Codex skill loading via
$autoresearchmention - All 10 subcommand keywords work in Codex
- Install script
--codex --globalon macOS/Linux - Install script
--codex --localin project -
$CODEX_HOMEenvironment variable respected -
sync-codex.shproduces clean output from canonical source - Implicit invocation triggers from task descriptions
Full Changelog: v2.0.0-beta.0.1...v2.0.0-beta.0.2