Codex Agents Composer

A desktop application for managing your Codex agents and their skills.

---

Overview

Codex Agents Composer provides a visual interface for creating, configuring, and organizing Codex agents. Instead of editing configuration files by hand, you can manage everything through a straightforward desktop app — define agents, assign skills, and fine-tune settings in one place.

Features

• Agent management — Create and configure Codex agents with a friendly UI. Set models, reasoning levels, and developer instructions without touching config files.
• Global and project-scoped agents — Save agents globally in ~/.codex/agents/ or attach them to a specific project in .codex/agents/.
• Skill catalog — Browse available skills from the skills.sh repository or create your own in the integrated editor.
• Drag-and-drop assignment — Assign skills to agents by dragging them from the catalog. Reorder or remove assignments just as easily.
• Persistent configuration — All changes are saved to your Codex config (~/.codex/), so agents and skills are ready to use from the command line immediately.

Installation

Requires Bun.

bun install

Usage

bun run dev:hmr

This starts the app with hot module reloading for the UI.

Alternatively, to run without HMR:

bun run start

Building

To produce a distributable application bundle:

bun run build:app

For a release-channel package build:

bun run build:release

Current ElectroBun packaging outputs for this project are:

• macOS: .dmg
• Windows: installer .exe bundled in a .zip
• Linux: installer .tar.gz

License

MIT