{"id":50518192,"url":"https://github.com/fusengine/codex-agent","last_synced_at":"2026-06-03T01:32:02.983Z","repository":{"id":356367468,"uuid":"1231301625","full_name":"fusengine/codex-agent","owner":"fusengine","description":"Redefining development through cognitive automation and collaborative agent systems.","archived":false,"fork":false,"pushed_at":"2026-05-07T18:12:40.000Z","size":13413,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T20:06:59.886Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fusengine.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-06T20:41:06.000Z","updated_at":"2026-05-07T18:15:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fusengine/codex-agent","commit_stats":null,"previous_names":["fusengine/codex-agent"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/fusengine/codex-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fusengine%2Fcodex-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fusengine%2Fcodex-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fusengine%2Fcodex-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fusengine%2Fcodex-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fusengine","download_url":"https://codeload.github.com/fusengine/codex-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fusengine%2Fcodex-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33844686,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-03T01:32:02.406Z","updated_at":"2026-06-03T01:32:02.978Z","avatar_url":"https://github.com/fusengine.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fusengine Codex Plugins\n\n![version](https://img.shields.io/badge/version-v1.0.0-blue?style=flat-square) ![plugins](https://img.shields.io/badge/plugins-17-brightgreen?style=flat-square) ![agents](https://img.shields.io/badge/agents-21-blueviolet?style=flat-square) ![skills](https://img.shields.io/badge/skills-131-orange?style=flat-square) ![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square) ![platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=flat-square) ![Codex CLI](https://img.shields.io/badge/Codex_CLI-0.128%2B-black?style=flat-square)\n\n\u003e A plugin ecosystem that turns Codex into a supervised, multi-agent development environment. Expert agents write code, hooks enforce quality in real-time, skills inject framework-specific knowledge, and **intelligent cartography auto-maps plugins and projects** — so Codex never guesses, never duplicates, and always follows your architecture.\n\n![Statusline](docs/img/statusline.png)\n\n## What It Does\n\n**Without plugins:** Codex writes code based on its training data. It can hallucinate APIs, duplicate existing code, ignore your project structure, and produce inconsistent quality.\n\n**With Fusengine plugins:**\n\n- **Expert agents** detect your project type (Next.js, Laravel, React, Astro, Swift...) and load framework-specific documentation via MCP servers before writing a single line\n- **148 hooks** intercept every Write/Edit/Bash/MCP call in real-time to enforce file size limits (\u003c100 lines), block code duplication (DRY), require SOLID references, and validate security\n- **131 skills** inject copy-paste-ready templates, architecture patterns, and best practices directly into agent context — no hallucination needed\n- **APEX workflow** structures every task through Analyze → Plan → Execute (TDD) → Review → Validate — preventing the \"just write code and hope\" approach\n- **Sniper validation** runs a 7-phase quality check after every modification: explore → research → grep usages → lint → fix → zero errors\n\n## Quick Install\n\n```bash\n# Add marketplace\n/plugin marketplace add fusengine/codex-agent\n\n# Install all plugins\n/plugin install fuse-ai-pilot fuse-commit-pro fuse-laravel fuse-nextjs fuse-react fuse-astro fuse-swift-apple-expert fuse-solid fuse-tailwindcss fuse-design fuse-prompt-engineer fuse-shadcn-ui fuse-security fuse-changelog\n\n# Setup (hooks + API keys + MCP servers + feature flags)\n~/.codex/.tmp/marketplaces/fusengine-plugins/setup.sh        # macOS / Linux\n~/.codex/.tmp/marketplaces/fusengine-plugins/setup.ps1       # Windows (run via PowerShell)\n```\n\n**Statusline (optional):**\n```bash\nbun --cwd ~/.codex/plugins/cache/fusengine-plugins/core-guards/\u003cversion\u003e/statusline run config\n```\n\n## How It Works\n\n```\nUser prompt → Hook detects project type → Expert agent activated\n            → Hook loads SOLID references → Agent reads docs via MCP\n            → Hook blocks if DRY violation → Agent writes code\n            → Hook checks file size → Sniper validates quality\n            → Hook blocks secrets → Commit with version bump\n```\n\nEvery step is intercepted. Codex cannot skip research, cannot duplicate code, cannot exceed file size limits, and cannot commit without security validation.\n\n## Plugins\n\n### Development — Framework Expert Agents\n\nEach plugin provides an **expert agent** that auto-activates when it detects the framework in your project. The agent has access to official documentation via MCP servers and follows SOLID principles enforced by hooks.\n\n| Plugin | Detects | What the agent does |\n|--------|---------|---------------------|\n| [fuse-nextjs](docs/plugins/nextjs.md) | `next.config.*` | App Router, RSC, Prisma 7, Better Auth, proxy.ts patterns |\n| [fuse-laravel](docs/plugins/laravel.md) | `composer.json` + `artisan` | Eloquent, Livewire, Blade, queues, Sanctum, Stripe Connect |\n| [fuse-react](docs/plugins/react.md) | `package.json` + React | React 19 hooks, TanStack Router/Form, Zustand stores |\n| [fuse-astro](docs/plugins/astro.md) | `astro.config.*` | Islands, Content Layer, Actions, SEO, Starlight, i18n |\n| [fuse-swift-apple-expert](docs/plugins/swift.md) | `Package.swift` | SwiftUI, concurrency, all Apple platforms (iOS → visionOS) |\n| [fuse-tailwindcss](docs/plugins/tailwindcss.md) | `tailwind.config.*` | v4.1 CSS-first config, @theme, @utility, OKLCH colors |\n| [fuse-design](docs/plugins/design.md) | Any UI task | Gemini Design MCP + shadcn/ui + WCAG 2.2 accessibility |\n| [fuse-shadcn-ui](docs/plugins/shadcn.md) | `components.json` | Radix/Base UI detection, registry, theming, migration |\n\n### Quality \u0026 Security — Automated Enforcement\n\n| Plugin | What it enforces |\n|--------|-----------------|\n| [fuse-ai-pilot](docs/plugins/ai-pilot.md) | APEX workflow orchestration, 7-phase sniper validation, DRY detection via jscpd, 4-level cache (60-75% token savings) |\n| [fuse-security](docs/plugins/security.md) | OWASP Top 10 scanning, CVE research via NVD/OSV.dev, dependency audit, secrets detection, auth patterns audit |\n| [fuse-solid](docs/plugins/solid.md) | Files \u003c 100 lines, interface separation, JSDoc mandatory — auto-detected for TypeScript, PHP, Swift, Go, Java, Ruby, Rust |\n\n### Productivity — Automation\n\n| Plugin | What it automates |\n|--------|-------------------|\n| [fuse-commit-pro](docs/plugins/commit-pro.md) | Conventional commits with security check, auto version bump, CHANGELOG, git tag — blocks secrets from commits |\n| [fuse-prompt-engineer](docs/plugins/prompt-engineer.md) | Prompt creation with CoT/Few-Shot/Meta-Prompting, A/B testing, 50+ template library, agent design |\n| [fuse-cartographer](docs/plugins/cartographer.md) | Intelligent cartography: auto-generates navigable maps of plugins and projects at SessionStart with merge-preserving enrichment — agents navigate via linked index trees, `/map --enrich` completes descriptions from source frontmatter |\n| [fuse-changelog](docs/plugins/changelog.md) | Monitors Codex updates, detects breaking changes in plugins, gathers community feedback via Exa |\n\n### Core (auto-installed, always active)\n\n| Plugin | What it guards |\n|--------|----------------|\n| core-guards | Blocks `git push --force`, `rm -rf`, `npm install` without lock, enforces SOLID file limits, tracks session state, DRY duplication blocking |\n| codex-rules | Injects APEX/SOLID/DRY rules into every prompt so Codex never forgets the methodology |\n\n## Key Features\n\n| Feature | How it prevents mistakes |\n|---------|-------------------------|\n| **APEX Workflow** | Forces Analyze before coding — no more \"let me just write this real quick\" |\n| **[Agent Teams](docs/workflow/agent-teams.md)** | Parallel agents with exclusive file ownership — no merge conflicts |\n| **DRY Detection** | Blocks Write/Edit if function/class name already exists — forces import or shared extraction |\n| **SOLID Hooks** | Denies file save if \u003e100 lines or missing SOLID reference read |\n| **Sniper Validation** | 7-phase post-edit check: explore → research → grep → lint → fix → zero errors |\n| **[4-Level Cache](docs/reference/cache-system.md)** | Caches exploration, docs, lessons, tests — 60-75% token savings |\n| **28 MCP Servers** | Context7, Exa, Astro docs, Gemini Design, shadcn, Playwright, and more |\n| **Smart Commits** | Security scan before commit, auto version bump, CHANGELOG, shields.io badge sync |\n| **`.codexignore`** | Bloque les writes/edits sur fichiers sensibles (gitignore-style) — `.env`, `secrets/`, `*.key` jamais touchés |\n| **Transcript watcher** | Capture les outils natifs Codex non-hookables (`read_file`, `web_search`, `spawn_agent`) via tail du rollout JSONL — alimente les guards APEX |\n| **Cross-platform TTS** | Notification audio fin de tâche : macOS (`afplay`), Linux (`paplay`/`aplay`/`mpv`/`ffplay`), Windows (`SoundPlayer`) |\n| **Codex feature flags** | Audit 0.130 : `hooks`, `tool_search`, `personality`, `multi_agent`, `fast_mode`, `shell_snapshot`, `enable_request_compression`, `skill_mcp_dependency_install`, `memories`, `goals` (defaults) + 6 prompts (`memories`, `apps`, `approval_policy`, `sandbox_mode`, `web_search`, `model_reasoning_effort`) |\n| **Codex 0.130 compliant** | Token-economy model mapping (`opus → gpt-5.5 high`, `sonnet → gpt-5.4 medium`, `haiku → gpt-5.4-mini low`), subagent filenames `\u003cplugin-slug\u003e-\u003cagent\u003e.toml`, per-agent MCP scoping (research-expert, design-expert, websearch), `[agents]` global config, opt-in `approval_mode` prompt, 131 skills with strict `name`+`description`-only frontmatter |\n\n## Documentation\n\n| Section | Content |\n|---------|---------|\n| [Getting Started](docs/getting-started/) | Installation, configuration, first steps |\n| [Workflow](docs/workflow/) | APEX methodology, agents, skills, commands |\n| [Plugins](docs/plugins/) | Per-plugin documentation and skills |\n| [Reference](docs/reference/) | Architecture, hooks, MCP servers, cache system |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffusengine%2Fcodex-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffusengine%2Fcodex-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffusengine%2Fcodex-agent/lists"}