🚧 Multiple agent providers support coming soon
A local web floor where a master Orchestrator plans and delegates to Codex or Claude Code agents, each running its real CLI in a live terminal. Every view, guard and workflow is a hot-reloading mod you can even generate from one sentence.
I use Codex every day. I also love two ideas from the Claude world, and I didn't want to choose.
Inspired by Munder Difflin: a whole floor of agents, where you see who's working and who's stuck and needs you, and agents hand work to each other.
Inspired by Claude Code mods: a few lines of on(event, ($, e, next) => …) add a pane, guard a tool call or rewrite a prompt, and it hot-reloads.
universalMods brings both to Codex and Claude Code, in the browser.
Drag panes to dock or swap, resize, collapse, maximize, add any mod as a panel, and save it. Every layout below ships built in: open one with ?layout=<name>.
A thin shell, with everything else built as a mod you can change.
Every agent runs its real CLI. Click its tile and its terminal fills the pane: watch it work, type into it, or queue messages. A permanent master orchestrator is always there.
Every agent gets hive tools: a kanban, a plan board, messages to other agents, spawning teammates, and ask_user when stuck.
A PM agent drafts a roadmap from your brief and renders it as a Mermaid flowchart. Progress moves as tagged kanban tasks get done.
Agents run unrestricted by default. A mod can still deny a dangerous call before it runs, on either platform.
Put any view in any pane: grid, timeline, kanban, roadmap or your own. Save named layouts and share them with ?layout=.
Describe a mod in plain English. A Mod Builder agent writes it, checks it loads, and it hot-reloads straight into your floor.
Drop a folder into mods/ with a mod.json, then add a server half to hook events, a client half to add views, or both.
next() to pass an event on, return a value to answer it, or call next({...e}) to rewrite it.$.tool.register adds a hive tool on both platforms.config.build lets a mod tweak each agent's Codex TOML or Claude settings.registerView plus hooks for the live floor state.// mods/budget/server.ts: hold agents that overspend export const register = (on, options) => { on('agent.event', (e) => e.event.kind === 'usage', ($, e, next) => { if (e.agent.usage.costUsd > 0.5) { $.agent.hold(e.agent.id, true); $.ui.toast(`${e.agent.name} hit the budget`); } return next(); }); // guard: works on Codex and Claude alike on('tool.call', ($, e, next) => /rm -rf \//.test(e.input?.command ?? '') ? { decision: 'deny', reason: 'nope' } : next()); };
Codex and Claude Code configure the same things very differently, so each floor runs one platform and has a config adapter for it. Your global ~/.codex and ~/.claude setup is never modified.
| Concept | Codex | Claude Code |
|---|---|---|
| Runtime | codex app-server (JSON-RPC) | claude -p stream-json |
| No-limits mode | danger-full-access, approval never | --dangerously-skip-permissions |
| Config | -c key=<toml> overrides plus thread params | per-agent --settings JSON |
| Skills | .agents/skills | session plugin via --plugin-dir |
| Hive tools | mcp_servers.hive | --mcp-config |
| Steer | native turn/steer | interrupt, then continue the session |
🚧 Multiple agent providers support coming soon. universalMods currently targets Codex and Claude Code only. Support for more agent platforms is coming. Each platform is a provider under src/providers/, so contributions are welcome.
You need Node 20 or later, plus Codex or Claude Code installed and logged in.
git clone https://github.com/samridh3215/universalMods.git cd universalMods && npm install
npm run dev -- --provider codex # or: --provider claude
?token=…). Add &layout=showcase for the view in the screenshots, spawn agents, and build mods from the 🧩 menu./plugin install universalmods --marketplace samridh3215/universalMods
⚠️ Agents run with no permission limits and can do anything your user account can. The server binds to 127.0.0.1 and requires the per-run token.