Docs › Settings & config

Settings & config

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

Last updated: 2026-02-13 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

Use in-app status signals to monitor long-running sessions.

Tip: Keep the dashboard visible for long-running tasks to avoid manual polling.

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. Typical flow: push from your main machine, then pull on your second machine.

What syncs

Profile credentials, 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 on macOS or Linux.

Pre-pull backups

Before every pull, CodexUse creates an automatic local pre-pull backup (latest 3 retained).

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.

Example: keep your main setup on a MacBook, then run codexuse sync pull on a Linux box to start with the same profiles and config.

For a full walkthrough, see the cloud sync guide.

Updates

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