Docs › Settings & config

Settings & config

Control how CodexUse and Codex CLI behave: models, approvals, sandbox mode, and config.toml.

Last updated: 2026-01-27 Settings

Quick settings

Model selection for chat and reviews.
Approval policy (auto or manual).
Sandbox mode and defaults.

config.toml editor

Edit Codex CLI config without hand-editing files. Use presets or paste your own.

Model defaults

Set chat + review models and reasoning levels.

Approvals

Choose manual or auto approvals for actions.

Sandbox mode

Pick safe defaults for shell + file actions.

Notifications

Enable in-app alerts and completion beeps to know when sessions finish.

Tip: Keep alerts on for long-running tasks to avoid checking manually.

AGENTS.md

Write persistent agent instructions once and reuse them across sessions.

Global AGENTS.md for all projects.
Project-level overrides when needed.
Keep instructions short and actionable.

Cloud Sync Pro

Sync your profiles, config.toml, and app settings across devices with manual push and pull.

What syncs

Profile auth records, config.toml content, and CodexUse settings. Sessions and chat history stay local.

Push & Pull

Go to Settings → Cloud Sync and click Push or Pull. Or use codexuse sync push / codexuse sync pull from the CLI.

Pre-pull backups

Before every pull, a backup is saved to ~/.codexuse/sync-backups/. Last 3 backups are kept.

Note: Cloud sync is manual and Pro-only. Nothing syncs without your action. Conflicts use last-writer-wins — if your push is older than the remote, you will be asked to pull first.

For a full walkthrough, see the cloud sync guide.

Updates

CodexUse can check for updates and install new releases when available.