firman-admin/codex-workflow-bindings
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Codex CLI bindings for the 7-phase software development workflow - agents, skills, hooks, config
2 commits 1 branch 0 tags 114 KiB
  • JavaScript 41.5%
  • HTML 28.1%
  • PowerShell 13.6%
  • Shell 11.8%
  • TypeScript 5%
Find a file
Exact
firman-admin f3359a0d10 feat(forgejo): replace fj CLI with curl API for issue mirroring and PR creation (bash port) 
- planner: create issues per task after approval, store IDs in task_plan.md
- shipper: create PR via API, close all task issues on merge
- references opencode-workflow-core/reference/forgejo-api.md
2026-07-21 13:29:04 +07:00
.codex feat(forgejo): replace fj CLI with curl API for issue mirroring and PR creation (bash port) 2026-07-21 13:29:04 +07:00
.gitignore chore: initial — Codex CLI bindings with agents, skills, hooks, config 2026-07-20 21:39:05 +07:00
AGENTS.md chore: initial — Codex CLI bindings with agents, skills, hooks, config 2026-07-20 21:39:05 +07:00
bootstrap.ps1 chore: initial — Codex CLI bindings with agents, skills, hooks, config 2026-07-20 21:39:05 +07:00
bootstrap.sh chore: initial — Codex CLI bindings with agents, skills, hooks, config 2026-07-20 21:39:05 +07:00
device-config.json.example chore: initial — Codex CLI bindings with agents, skills, hooks, config 2026-07-20 21:39:05 +07:00
README.md chore: initial — Codex CLI bindings with agents, skills, hooks, config 2026-07-20 21:39:05 +07:00

README.md

Codex Workflow Bindings

Codex CLI bindings for the opencode-workflow-core 7-phase software development workflow.

Contains Codex CLI-specific agent definitions (.codex/agents/*.toml), skills, hooks config, and bootstrap scripts. Core phase docs live in opencode-workflow-core — this repo only has the Codex-specific binding layer.

Contents

Path Purpose
.codex/agents/*.toml 11 agent definitions (conductor, orchestrator, architect, planner, etc.)
.codex/skills/ 10 skills (tdd-runner, interviewer, shipper, debugger, etc.)
.codex/templates/ PR body, task plan, SPEC templates
.codex/hooks.json Codex lifecycle hooks configuration
.codex/config.toml Codex project configuration with profiles
AGENTS.md Hierarchical workflow instructions for Codex
bootstrap.ps1 Windows setup script
bootstrap.sh macOS/Linux setup script

Install

Windows (PowerShell 5.1+)

iex ((New-Object Net.WebClient).DownloadString('https://{forgejo.url}/{forgejo.user}/codex-workflow-bindings/raw/branch/main/bootstrap.ps1'))

macOS/Linux

curl -fsSL https://{forgejo.url}/{forgejo.user}/codex-workflow-bindings/raw/branch/main/bootstrap.sh | bash

What the bootstrap does

  1. Clones opencode-workflow-core + codex-workflow-bindings
  2. Replaces {forgejo.url}, {forgejo.user}, {model.conductor}, {model.worker} placeholders using device config
  3. Copies skills → ~/.codex/skills/
  4. Copies templates → ~/.codex/templates/
  5. Installs hooks → ~/.codex/hooks.json
  6. Links workflow docs → ~/.codex/workflow-docs/

Usage

Start a Codex session in any project. Codex auto-loads AGENTS.md from the root (see AGENTS.md loading order). The workflow instructions guide each phase.

Quick reference

Intent Action
New feature Let the conductor guide Phase 1→7
Debug bug /debugger
Add tests Spawn @tdd-runner or /tdd-runner
Map codebase Spawn @codebase-explorer
Review code Spawn @spec-reviewer + @quality-reviewer
Ship feature /shipper

Placeholder Parameterization

On first bootstrap, device-config.json is created at ~/.codex/device-config.json:

{
  "forgejoUrl": "git.firmanserver.com",
  "forgejoUser": "firman-admin",
  "modelConductor": "o4-mini",
  "modelWorker": "o4-mini"
}

Subsequent boots reuse this config. To re-parameterize: delete the file and re-run bootstrap.