{"id":51328338,"url":"https://github.com/devfolioco/codex-plugin","last_synced_at":"2026-07-01T20:31:17.264Z","repository":{"id":367241178,"uuid":"1232842583","full_name":"devfolioco/codex-plugin","owner":"devfolioco","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-25T06:10:27.000Z","size":27,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-25T07:16:01.702Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/devfolioco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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-08T10:27:56.000Z","updated_at":"2026-06-25T06:10:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/devfolioco/codex-plugin","commit_stats":null,"previous_names":["devfolioco/codex-plugin"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/devfolioco/codex-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devfolioco%2Fcodex-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devfolioco%2Fcodex-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devfolioco%2Fcodex-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devfolioco%2Fcodex-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devfolioco","download_url":"https://codeload.github.com/devfolioco/codex-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devfolioco%2Fcodex-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35022601,"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-07-01T02:00:05.325Z","response_time":130,"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-07-01T20:31:16.548Z","updated_at":"2026-07-01T20:31:17.255Z","avatar_url":"https://github.com/devfolioco.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Devfolio Codex Plugin\n\nThis repository contains the Devfolio plugin for Codex. It lets Codex work with Devfolio through the Devfolio MCP server, including hackathon project submissions, profile side projects, active hackathon discovery, track/prize lookup, and upload URL generation.\n\n## What It Includes\n\n- A `devfolio` skill for preparing and safely managing project submissions through Devfolio MCP.\n- A Codex plugin manifest at `plugins/devfolio/.codex-plugin/plugin.json`.\n- A hosted MCP configuration at `plugins/devfolio/.mcp.json`.\n- MCP workflow guidance for Devfolio project and submission tools.\n\n## Install\n\nAdd the Devfolio plugin marketplace:\n\n```bash\ncodex plugin marketplace add devfolioco/codex-plugin\n```\n\nThen open the Codex Plugins screen, choose Devfolio, and install the plugin.\n\nFor local development, clone this repository:\n\n```bash\ngit clone git@github.com:devfolioco/codex-plugin.git\n```\n\nThen add the checkout as a local Codex plugin marketplace:\n\n```bash\ncodex plugin marketplace add /path/to/codex-plugin\n```\n\nAfter installation, start a new Codex thread and invoke the plugin with:\n\n```text\n@devfolio show my active hackathons\n```\n\n## MCP Setup\n\nThe plugin declares the hosted Devfolio MCP endpoint:\n\n```json\n{\n  \"mcpServers\": {\n    \"devfolio\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.devfolio.co/mcp\"\n    }\n  }\n}\n```\n\nConnect Devfolio MCP with the bare MCP URL:\n\n```bash\ncodex mcp add devfolio \\\n  --url \"https://mcp.devfolio.co/mcp\"\n```\n\nDevfolio MCP uses OAuth. Codex should open a Devfolio consent screen during setup, where you can authorize Codex to read your Devfolio identity, profile, hackathon participation, and projects, plus manage projects when you ask Codex to create or update them.\n\nAfter authorizing, start a new Codex thread and invoke the plugin:\n\n```text\n@devfolio show my active hackathons\n```\n\nIf Codex says an MCP server named `devfolio` already exists, remove the existing entry and add it again:\n\n```bash\ncodex mcp remove devfolio\ncodex mcp add devfolio \\\n  --url \"https://mcp.devfolio.co/mcp\"\n```\n\nFor staging, internal testers can use the same shape with the Devrel endpoint:\n\n```bash\ncodex mcp add devfolio \\\n  --url \"https://mcp.devrel.in/mcp\"\n```\n\nLegacy MCP URLs with `apiKey` query parameters are no longer valid for production. Remove the key from any existing Devfolio MCP config and reconnect with the bare MCP URL.\n\n### OAuth Flow\n\n1. Install the plugin from the Devfolio marketplace.\n2. Connect the hosted MCP server with `codex mcp add devfolio --url \"https://mcp.devfolio.co/mcp\"`.\n3. Complete the Devfolio consent screen when Codex opens it.\n4. Start a new Codex thread and use `@devfolio`.\n\nThe OAuth connection lets Codex call Devfolio MCP tools on your behalf. The plugin still requires explicit confirmation before create, update, upload, or publish actions.\n\n## Safety\n\nDevfolio project publishing can make a project public immediately. The skill requires explicit confirmation before all create/update calls and before any `status: \"publish\"` action.\n\n## Compatibility Notes\n\nKeep future MCP and plugin changes additive where possible:\n\n- Preserve the disconnected onboarding path so users without MCP auth understand that account-specific Devfolio MCP actions require OAuth authentication.\n- Preserve existing tool names and argument meanings; add new optional fields or new tools before changing current flows.\n- Use the OAuth-capable bare MCP URL for setup.\n- Treat team support as an authorization-sensitive extension. Before create, update, or publish actions, the agent should read the current project/team state when available and ask for explicit confirmation.\n- Keep draft-first behavior and explicit publish confirmation as stable safety guarantees.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevfolioco%2Fcodex-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevfolioco%2Fcodex-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevfolioco%2Fcodex-plugin/lists"}