Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

Checkpoint: File edits

rUvef63cb798a4b
diff --git a/docs/adr/ADR-027-codex-package-analysis.md b/docs/adr/ADR-027-codex-package-analysis.md
index 01cd324783..dc5a5ee595 100644
--- a/docs/adr/ADR-027-codex-package-analysis.md
+++ b/docs/adr/ADR-027-codex-package-analysis.md
@@ -562,3 +562,76 @@ The undocumented features provide significant opportunities for deep integration
- **Dynamic tools** for runtime extensibility
The package architecture is similar to Claude Code's approach, making it straightforward to create a compatible Codex integration in claude-flow.
+
+## @claude-flow/codex Package
+
+Based on this analysis, we've created the `@claude-flow/codex` package as the first step in the coflow rebranding initiative.
+
+### Package Location
+
+```
+v3/@claude-flow/codex/
+β”œβ”€β”€ package.json
+β”œβ”€β”€ tsconfig.json
+└── src/
+ β”œβ”€β”€ index.ts # Main exports
+ β”œβ”€β”€ types.ts # TypeScript definitions
+ β”œβ”€β”€ cli.ts # CLI entry point
+ β”œβ”€β”€ initializer.ts # CodexInitializer class
+ β”œβ”€β”€ generators/
+ β”‚ β”œβ”€β”€ index.ts
+ β”‚ β”œβ”€β”€ agents-md.ts # AGENTS.md generator
+ β”‚ β”œβ”€β”€ skill-md.ts # SKILL.md generator
+ β”‚ └── config-toml.ts # config.toml generator
+ β”œβ”€β”€ templates/
+ β”‚ └── index.ts # Built-in templates and skills
+ β”œβ”€β”€ validators/
+ β”‚ └── index.ts # Validation functions
+ └── migrations/
+ └── index.ts # Claude Code β†’ Codex migration
+```
+
+### Key Features
+
+| Feature | Description |
+|---------|-------------|
+| AGENTS.md Generator | Full/default/minimal/enterprise templates |
+| SKILL.md Generator | 6 built-in skills + custom skill support |
+| config.toml Generator | Profile support, MCP servers, features |
+| Migration Tools | Claude Code to Codex migration with analysis |
+| Validators | Validate AGENTS.md, SKILL.md, config.toml |
+| Dual Mode | Generate both Claude Code and Codex configs |
+
+### CLI Commands
+
+```bash
+# Initialize new Codex project
+npx @claude-flow/codex init --template default
+
+# Generate custom skill
+npx @claude-flow/codex generate-skill --name my-skill
+
+# Validate configuration
+npx @claude-flow/codex validate
+
+# Migrate from Claude Code
+npx @claude-flow/codex migrate --from CLAUDE.md
+
+# List available templates
+npx @claude-flow/codex templates
+
+# List built-in skills
+npx @claude-flow/codex skills
+```
+
+### Future: coflow Umbrella
+
+This package is the first step in transitioning from `claude-flow` to `coflow`:
+
+```bash
+# Current
+npx @claude-flow/codex init
+
+# Future (after umbrella rebrand)
+npx coflow init --codex
+```