Setup

Install Codex Commons

Add the Codex Commons marketplace to Codex, then install the plugins you need from plugin settings.

MarketplaceREADMESecurity model

Marketplace

Add marketplace

Run this command from your terminal:

$
codex plugin marketplace add taklegko/codex-commons@main

This installs Codex Commons from the moving main branch, so Codex can compare the remote Git revision when it refreshes configured marketplaces. After that, open Codex plugin settings, choose Codex Commons, and install the plugins you want.

Local development

Run the web app

For local work on this repository, start the Codex run script with your GitHub username.

$
CODEX_COMMONS_DEV_GITHUB_USER=taklegko npm run codex:run

The script starts local Supabase, injects the local API keys, creates a real local Supabase session, and runs validation locally.

GitHub OAuth

Allow localhost redirects

For OAuth testing against a hosted Supabase project, configure Supabase Auth URL settings with these local URLs.

URL
http://localhost:3000http://localhost:3000/auth/callbackhttp://localhost:3000/**

Keep NEXT_PUBLIC_SITE_URL=http://localhost:3000 in .env.local so OAuth returns to the same local app.