# Codex Mode

> Switch Codex App plugin sets by explicit working mode. Use when the user says "mode", "mode nextjs", "mode vite", "mode react-native", "mode ios", "mode tvos", "mode macos", "mode ai-app", "mode restore", "mode status", "mode list", "codex mode", "trocar modo", "ativar modo", or asks to reduce Codex plugin or skill context by selecting a focused plugin mode.

- Skill: `joaoalvess/codex-mode` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add joaoalvess/codex-mode`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joaoalvess/codex-mode/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: joaoalvess (https://skillmd.com/u/joaoalvess)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/joaoalvess/codex-mode

---


# Codex Mode

Use this skill to switch the global Codex App plugin set for the next session. The current conversation does not hot-reload plugins after the config changes.

## Commands

Run the bundled script from this skill directory:

```bash
python3 scripts/codex_mode.py list
python3 scripts/codex_mode.py status
python3 scripts/codex_mode.py dry-run nextjs
python3 scripts/codex_mode.py apply nextjs
python3 scripts/codex_mode.py restore
```

## Workflow

1. If the user says only `mode`, run `python3 scripts/codex_mode.py list` and ask which specialized mode they want.
2. If the user says `mode list`, run `list`.
3. If the user says `mode status`, run `status`.
4. If the user says `mode restore`, run `dry-run restore`, summarize the diff, ask for confirmation, then run `restore` if confirmed.
5. If the user says `mode <name>` without `--yes`, run `dry-run <name>`, summarize the diff, and ask for confirmation before applying.
6. If the user says `mode <name> --yes`, run `apply <name>` directly.

Keep responses short. Do not autodetect a project type. The user chooses the mode.

## Modes

Specialized modes are:

- `vite`
- `nextjs`
- `react-native`
- `ios`
- `tvos`
- `macos`
- `ai-app`

`restore` returns to the base plugin set.

## Safety

- The script changes only managed `[plugins."<plugin-id>"].enabled` values in `~/.codex/config.toml`.
- The script creates a timestamped backup under `~/.codex/backups/codex-mode/` before every write.
- After applying, tell the user to open a new Codex App conversation or restart the app/workspace for the new plugin context to load.