{"id":31328073,"url":"https://github.com/rmncldyo/create-codex","last_synced_at":"2026-01-12T02:28:09.636Z","repository":{"id":313777954,"uuid":"1052630958","full_name":"RMNCLDYO/create-codex","owner":"RMNCLDYO","description":"AGENTS.md setup that just works. Bootstrap every project with the open standard for AI coding agents. One command, zero headaches.","archived":false,"fork":false,"pushed_at":"2025-09-22T19:50:56.000Z","size":72,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-22T21:26:34.282Z","etag":null,"topics":["agents","agents-md","ai","ai-agents","aider","cli","codex","codex-cli","cursor","jules","open-ai","openai","windsurf","zed"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/create-codex","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/RMNCLDYO.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":"CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","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},"funding":{"github":["RMNCLDYO"]}},"created_at":"2025-09-08T10:24:36.000Z","updated_at":"2025-09-22T19:50:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"89552fb4-2b89-475d-bdc9-bfe3da156984","html_url":"https://github.com/RMNCLDYO/create-codex","commit_stats":null,"previous_names":["rmncldyo/create-codex"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/RMNCLDYO/create-codex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2Fcreate-codex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2Fcreate-codex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2Fcreate-codex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2Fcreate-codex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RMNCLDYO","download_url":"https://codeload.github.com/RMNCLDYO/create-codex/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RMNCLDYO%2Fcreate-codex/sbom","scorecard":{"id":1238020,"data":{"date":"2025-09-22T19:51:06Z","repo":{"name":"github.com/RMNCLDYO/create-codex","commit":"d511b63d075b0e41f777a980cb343cb516649e6a"},"scorecard":{"version":"v5.2.1","commit":"ab2f6e92482462fe66246d9e32f642855a691dc1"},"score":6.9,"checks":[{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#maintained"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#security-policy"}},{"name":"Code-Review","score":0,"reason":"Found 0/2 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#binary-artifacts"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#dependency-update-tool"}},{"name":"Token-Permissions","score":10,"reason":"GitHub workflow tokens follow principle of least privilege","details":["Warn: jobLevel 'contents' permission set to 'write': .github/workflows/publish.yml:16","Info: jobLevel 'actions' permission set to 'read': .github/workflows/scorecard.yml:19","Info: jobLevel 'contents' permission set to 'read': .github/workflows/scorecard.yml:20","Info: jobLevel 'contents' permission set to 'read': .github/workflows/security.yml:25","Info: topLevel 'contents' permission set to 'read': .github/workflows/audit-signatures.yml:16","Info: topLevel 'contents' permission set to 'read': .github/workflows/ci.yml:18","Info: topLevel 'contents' permission set to 'read': .github/workflows/fuzz-testing.yml:18","Info: topLevel 'contents' permission set to 'read': .github/workflows/publish.yml:9","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/security.yml:16"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":10,"reason":"all dependencies are pinned","details":["Info:  23 out of  23 GitHub-owned GitHubAction dependencies pinned","Info:   7 out of   7 third-party GitHubAction dependencies pinned","Info:   7 out of   7 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#pinned-dependencies"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#license"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/publish.yml:13"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#packaging"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#cii-best-practices"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#vulnerabilities"}},{"name":"Signed-Releases","score":8,"reason":"1 out of the last 1 releases have a total of 1 signed artifacts.","details":["Info: signed release artifact: create-codex-0.1.0.ms-spdx.json.asc: https://github.com/RMNCLDYO/create-codex/releases/tag/v0.1.0","Warn: release artifact v0.1.0 does not have provenance: https://api.github.com/repos/RMNCLDYO/create-codex/releases/245484649"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#signed-releases"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: SAST configuration detected: CodeQL","Info: SAST configuration detected: CodeQL","Info: all commits (6) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#sast"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#branch-protection"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#fuzzing"}},{"name":"Contributors","score":-1,"reason":"internal error: Client.Repositories.ListContributors: error during contributorsHandler.setup: error during ParseFile: line 5: unexpected character '\u003c' at position 1","details":null,"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#contributors"}},{"name":"CI-Tests","score":10,"reason":"6 out of 6 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#ci-tests"}}]},"last_synced_at":"2025-09-22T21:27:52.010Z","repository_id":313777954,"created_at":"2025-09-22T21:27:52.010Z","updated_at":"2025-09-22T21:27:52.010Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276999558,"owners_count":25742812,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-25T02:00:09.612Z","response_time":80,"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":["agents","agents-md","ai","ai-agents","aider","cli","codex","codex-cli","cursor","jules","open-ai","openai","windsurf","zed"],"created_at":"2025-09-25T23:51:09.560Z","updated_at":"2025-09-25T23:51:13.558Z","avatar_url":"https://github.com/RMNCLDYO.png","language":"TypeScript","funding_links":["https://github.com/sponsors/RMNCLDYO"],"categories":[],"sub_categories":[],"readme":"# create-codex\n\nAGENTS.md setup that just works. Bootstrap every project with the open standard for AI coding agents. One command, zero headaches.\n\n[![version](https://img.shields.io/npm/v/create-codex.svg?label=version\u0026color=brightgreen)](https://www.npmjs.com/package/create-codex)\n[![downloads](https://img.shields.io/npm/dm/create-codex.svg?label=downloads\u0026color=blue)](https://www.npmjs.com/package/create-codex)\n[![package size](https://img.shields.io/npm/unpacked-size/create-codex?label=package%20size\u0026color=yellow)](https://www.npmjs.com/package/create-codex)\n[![license](https://img.shields.io/badge/license-MIT-red.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n```bash\nnpm create codex\n```\n\n*Adds **local** AGENTS.md file to your project. ZERO dependencies, ZERO overhead.*\n\n## Installation Options\n\n### Package Managers\n\n```bash\nnpm create codex               # npm\npnpm create codex              # pnpm  \nbun create codex               # bun\nyarn create codex              # yarn\n```\n\n### Flags\n\n```bash\nnpm create codex --dry-run     # Preview files\nnpm create codex --help        # All options\n```\n\n### Shortcuts\n\n```bash\nnpx create-codex                # Direct execution\nnpx create-codex my-project     # Create in specific directory\n```\n\n## Programmatic Usage\n\n### Installation\n\n```bash\nnpm i create-codex\n```\n\n### Usage\n\n```typescript\nimport { init } from 'create-codex';\n\nawait init('./my-project');\n```\n\n## Features\n\n### Universal Compatibility\n\n- **Works everywhere**: Codex, Cursor, Aider, Jules, Zed, Windsurf, Continue, and more\n- **Open standard**: AGENTS.md is supported by 20k+ projects\n- **Zero lock-in**: One file that works with any AI coding agent\n\n### Intelligent Project Detection\n\n- **Runtime detection**: Node.js, Python, Rust, Go, Java, C/C++, TypeScript, Bun\n- **Framework detection**: React, Next.js, Vue, Angular, Svelte, Express, FastAPI\n- **Package manager detection**: npm, yarn, pnpm, bun, pip, poetry, uv\n- **Git integration**: Repository URL, branch information, user details\n\n### Production-Ready\n\n- **Atomic operations**: SHA256 verification and safe file writes\n- **Automatic backups**: Timestamped backups of existing files\n- **Template rendering**: Smart conditionals and variable substitution\n\n### Smart AGENTS.md Generation\n\n- **Setup commands**: Install, dev, build, test commands for your stack\n- **Code standards**: Language-specific best practices and conventions\n- **Development workflow**: Optimized step-by-step process\n- **Safety boundaries**: Security constraints and operational limits\n- **Project context**: Path, Git info, and environment details\n\n## FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eIs it safe to run?\u003c/strong\u003e\u003c/summary\u003e\n\nYes. It only creates an AGENTS.md file, never modifies your code. Each file operation uses SHA256 checksums and creates timestamped backups.\n\n```bash\n# If something goes wrong, backups are here:\nls .create-codex-backup-*\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eHow do I remove it?\u003c/strong\u003e\u003c/summary\u003e\n\nDelete the AGENTS.md file:\n\n```bash\nrm AGENTS.md\n```\n\nYour original code stays untouched.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWhat are the requirements?\u003c/strong\u003e\u003c/summary\u003e\n\n- Node.js 20+\n- Any AI coding agent that supports AGENTS.md\n\nThat's it. No global installs, no dependencies.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDoes it work with my tools?\u003c/strong\u003e\u003c/summary\u003e\n\nIt auto-detects:\n\n- **Package managers**: npm, yarn, pnpm, bun, pip, poetry, uv  \n- **Languages**: JavaScript, TypeScript, Python, Go, Rust, Java, C/C++\n- **Frameworks**: React, Vue, Next.js, Express, FastAPI, etc.\n\nCan't find your tool? It falls back to sensible defaults.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWhat files does it create?\u003c/strong\u003e\u003c/summary\u003e\n\nCreates 1 file:\n\n```\nAGENTS.md                   # Project-specific instructions for AI agents\n```\n\nFuture versions may support additional configuration in `.codex/` directory.\n\n\u003c/details\u003e\n\n## Security\n\nThis project follows security best practices:\n\n- All dependencies are audited and kept up-to-date\n- Code is scanned with CodeQL and other security tools\n- OpenSSF Scorecard certified\n- Signed releases with build provenance\n\nReport security issues: [SECURITY.md](SECURITY.md)\n\n## Contributing\n\nContributions welcome! Please read [SECURITY.md](SECURITY.md) first, then:\n\n1. Fork the repo\n2. Create a feature branch\n3. Run `npm run validate` before committing\n4. Submit a pull request\n\n## Links\n\n[**Issues**](https://github.com/RMNCLDYO/create-codex/issues) • [**Changelog**](https://github.com/RMNCLDYO/create-codex/blob/main/CHANGELOG.md) • [**AGENTS.md Docs**](https://agents.md) • [**Security**](SECURITY.md)\n\n## License\n\nMIT © [RMNCLDYO](https://github.com/RMNCLDYO)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmncldyo%2Fcreate-codex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frmncldyo%2Fcreate-codex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmncldyo%2Fcreate-codex/lists"}