tim-hub/powerball-harness / harness/skills/harness-setup
harness-setup
VerifiedInitializes and configures Harness in a project — CI, memory, duo workflow, Codex. Use when setting up a new project or adding Harness configuration.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.2 KB |
| references/codex.md | markdown | 2.1 KB |
| scripts/merge-gitignore.shexecutable | script | 1.1 KB |
| scripts/setup-codex.shexecutable | script | 4.4 KB |
| scripts/setup-opencode.shexecutable | script | 3.2 KB |
references/codex.md
View on GitHub# Harness Setup — Codex CLI
Reference for `harness-setup codex`: install Codex CLI and set up Harness skills in your project.
## Prerequisites
- Node.js 20+ (for `npm install`)
- A project already initialized with `harness-setup init`
## Installation
```bash
npm install -g @openai/codex
```
Verify:
```bash
codex --version
```
## Setup
Run the setup subcommand from Claude Code:
```
harness-setup codex
```
This copies Harness config and skills to your project's `.codex/` directory:
```
project/
├── .codexignore — Codex ignore patterns
├── AGENTS.md — Agent role reference (points to CLAUDE.md)
└── .codex/
├── config.toml — Multi-agent config (8 named agent profiles)
├── rules/
│ └── harness.rules — Guardrail rules (until Codex supports hooks)
└── skills/ — All Harness skills
├── harness-work/ — Codex-native implementation skill (override)
├── breezing/ — Codex-native team-execution skill (override)
└── ... — All other skills from skills/ (patched with disable-model-invocation)
```
## Running Codex with Harness Skills
```bash
# Interactive session
codex
# Run a specific task non-interactively
codex exec "implement task 3 from Plans.md"
# Delegate from a Claude Code session (recommended)
bash "${CLAUDE_PLUGIN_ROOT}/scripts/codex-companion.sh" task --write "your prompt"
```
See `harness/rules/codex-cli-only.md` for the full policy on Codex invocation.
## Re-running Setup
Setup is idempotent — re-running `harness-setup codex` overwrites `.codex/skills/` with fresh copies from the plugin. Run this after:
- Updating the Harness plugin
- Adding new skills to the plugin
## Troubleshooting
| Symptom | Fix |
|---------|-----|
| `codex: command not found` | Re-run `npm install -g @openai/codex` |
| Skills not loading | Re-run `harness-setup codex` to refresh `.codex/skills/` |
| Config not found | Re-run `harness-setup codex` to recopy `config.toml` |
| Multi-agent disabled | Ensure `[features] multi_agent = true` is in `.codex/config.toml` |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |