mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-05-13 03:52:00 +00:00
98db898c0b
Completes the Windows-gating coverage for the built-in skills/ tree. Every
bundled SKILL.md now carries an explicit platforms: declaration so the
loader (agent.skill_utils.skill_matches_platform) can skip-load skills
that don't fit the current OS.
74 skills declared cross-platform (platforms: [linux, macos, windows]):
Creative (16): ascii-art, ascii-video, architecture-diagram, baoyu-comic,
baoyu-infographic, claude-design, creative-ideation, design-md,
excalidraw, humanizer, manim-video, p5js, pixel-art,
popular-web-designs, pretext, sketch, songwriting-and-ai-music,
touchdesigner-mcp
Autonomous agents: claude-code, codex, hermes-agent, opencode
Data/devops: jupyter-live-kernel, kanban-orchestrator, kanban-worker,
webhook-subscriptions, dogfood, codebase-inspection
GitHub: github-auth, github-code-review, github-issues,
github-pr-workflow, github-repo-management
Media: gif-search, heartmula, songsee, spotify, youtube-content
MCP / email / gaming / notes / smart-home: native-mcp, himalaya,
pokemon-player, obsidian, openhue
mlops (non-broken): weights-and-biases, huggingface-hub, llama-cpp,
outlines, segment-anything-model, dspy, trl-fine-tuning
Productivity: airtable, google-workspace, linear, maps, nano-pdf,
notion, ocr-and-documents, powerpoint
Red-teaming / research: godmode, arxiv, blogwatcher, llm-wiki,
polymarket
Software-dev: debugging-hermes-tui-commands, hermes-agent-skill-authoring,
node-inspect-debugger, plan, requesting-code-review, spike,
subagent-driven-development, systematic-debugging,
test-driven-development, writing-plans
Misc: yuanbao
5 skills gated from Windows (platforms: [linux, macos]):
mlops/inference/vllm (serving-llms-vllm)
vLLM is officially Linux-only; Windows requires WSL.
mlops/training/axolotl
Axolotl's flash-attn + deepspeed + bitsandbytes stack is Linux-first.
mlops/training/unsloth
Requires Triton + xformers + flash-attn — Linux only in practice.
mlops/models/audiocraft (audiocraft-audio-generation)
torchaudio ffmpeg backend + encodec dependencies are Linux-first.
mlops/inference/obliteratus
Research abliteration workflow; relies on Linux-focused pytorch
kernels and MLX — no first-class Windows path.
Same strict-over-lenient policy as the optional-skills sweep: when the
underlying tool's Windows support is rough, missing, or WSL-only, gate the
skill. Easier to un-gate after verified Windows support lands than to leak
partial support that manifests as mid-task failures.
Combined with prior commits in this branch, every bundled SKILL.md
(skills/ + optional-skills/) now has a platforms: declaration.
130 lines
4.5 KiB
Markdown
130 lines
4.5 KiB
Markdown
---
|
|
name: codex
|
|
description: "Delegate coding to OpenAI Codex CLI (features, PRs)."
|
|
version: 1.0.0
|
|
author: Hermes Agent
|
|
license: MIT
|
|
platforms: [linux, macos, windows]
|
|
metadata:
|
|
hermes:
|
|
tags: [Coding-Agent, Codex, OpenAI, Code-Review, Refactoring]
|
|
related_skills: [claude-code, hermes-agent]
|
|
---
|
|
|
|
# Codex CLI
|
|
|
|
Delegate coding tasks to [Codex](https://github.com/openai/codex) via the Hermes terminal. Codex is OpenAI's autonomous coding agent CLI.
|
|
|
|
## When to use
|
|
|
|
- Building features
|
|
- Refactoring
|
|
- PR reviews
|
|
- Batch issue fixing
|
|
|
|
Requires the codex CLI and a git repository.
|
|
|
|
## Prerequisites
|
|
|
|
- Codex installed: `npm install -g @openai/codex`
|
|
- OpenAI auth configured: either `OPENAI_API_KEY` or Codex OAuth credentials
|
|
from the Codex CLI login flow
|
|
- **Must run inside a git repository** — Codex refuses to run outside one
|
|
- Use `pty=true` in terminal calls — Codex is an interactive terminal app
|
|
|
|
For Hermes itself, `model.provider: openai-codex` uses Hermes-managed Codex
|
|
OAuth from `~/.hermes/auth.json` after `hermes auth add openai-codex`. For the
|
|
standalone Codex CLI, a valid CLI OAuth session may live under
|
|
`~/.codex/auth.json`; do not treat a missing `OPENAI_API_KEY` alone as proof
|
|
that Codex auth is missing.
|
|
|
|
## One-Shot Tasks
|
|
|
|
```
|
|
terminal(command="codex exec 'Add dark mode toggle to settings'", workdir="~/project", pty=true)
|
|
```
|
|
|
|
For scratch work (Codex needs a git repo):
|
|
```
|
|
terminal(command="cd $(mktemp -d) && git init && codex exec 'Build a snake game in Python'", pty=true)
|
|
```
|
|
|
|
## Background Mode (Long Tasks)
|
|
|
|
```
|
|
# Start in background with PTY
|
|
terminal(command="codex exec --full-auto 'Refactor the auth module'", workdir="~/project", background=true, pty=true)
|
|
# Returns session_id
|
|
|
|
# Monitor progress
|
|
process(action="poll", session_id="<id>")
|
|
process(action="log", session_id="<id>")
|
|
|
|
# Send input if Codex asks a question
|
|
process(action="submit", session_id="<id>", data="yes")
|
|
|
|
# Kill if needed
|
|
process(action="kill", session_id="<id>")
|
|
```
|
|
|
|
## Key Flags
|
|
|
|
| Flag | Effect |
|
|
|------|--------|
|
|
| `exec "prompt"` | One-shot execution, exits when done |
|
|
| `--full-auto` | Sandboxed but auto-approves file changes in workspace |
|
|
| `--yolo` | No sandbox, no approvals (fastest, most dangerous) |
|
|
|
|
## PR Reviews
|
|
|
|
Clone to a temp directory for safe review:
|
|
|
|
```
|
|
terminal(command="REVIEW=$(mktemp -d) && git clone https://github.com/user/repo.git $REVIEW && cd $REVIEW && gh pr checkout 42 && codex review --base origin/main", pty=true)
|
|
```
|
|
|
|
## Parallel Issue Fixing with Worktrees
|
|
|
|
```
|
|
# Create worktrees
|
|
terminal(command="git worktree add -b fix/issue-78 /tmp/issue-78 main", workdir="~/project")
|
|
terminal(command="git worktree add -b fix/issue-99 /tmp/issue-99 main", workdir="~/project")
|
|
|
|
# Launch Codex in each
|
|
terminal(command="codex --yolo exec 'Fix issue #78: <description>. Commit when done.'", workdir="/tmp/issue-78", background=true, pty=true)
|
|
terminal(command="codex --yolo exec 'Fix issue #99: <description>. Commit when done.'", workdir="/tmp/issue-99", background=true, pty=true)
|
|
|
|
# Monitor
|
|
process(action="list")
|
|
|
|
# After completion, push and create PRs
|
|
terminal(command="cd /tmp/issue-78 && git push -u origin fix/issue-78")
|
|
terminal(command="gh pr create --repo user/repo --head fix/issue-78 --title 'fix: ...' --body '...'")
|
|
|
|
# Cleanup
|
|
terminal(command="git worktree remove /tmp/issue-78", workdir="~/project")
|
|
```
|
|
|
|
## Batch PR Reviews
|
|
|
|
```
|
|
# Fetch all PR refs
|
|
terminal(command="git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*'", workdir="~/project")
|
|
|
|
# Review multiple PRs in parallel
|
|
terminal(command="codex exec 'Review PR #86. git diff origin/main...origin/pr/86'", workdir="~/project", background=true, pty=true)
|
|
terminal(command="codex exec 'Review PR #87. git diff origin/main...origin/pr/87'", workdir="~/project", background=true, pty=true)
|
|
|
|
# Post results
|
|
terminal(command="gh pr comment 86 --body '<review>'", workdir="~/project")
|
|
```
|
|
|
|
## Rules
|
|
|
|
1. **Always use `pty=true`** — Codex is an interactive terminal app and hangs without a PTY
|
|
2. **Git repo required** — Codex won't run outside a git directory. Use `mktemp -d && git init` for scratch
|
|
3. **Use `exec` for one-shots** — `codex exec "prompt"` runs and exits cleanly
|
|
4. **`--full-auto` for building** — auto-approves changes within the sandbox
|
|
5. **Background for long tasks** — use `background=true` and monitor with `process` tool
|
|
6. **Don't interfere** — monitor with `poll`/`log`, be patient with long-running tasks
|
|
7. **Parallel is fine** — run multiple Codex processes at once for batch work
|