What's Changed

• feat(app): add app --instance flag, deprecate app-instance command by @Ducksss in #21

Full Changelog: v0.5.0...v0.6.0

Full Changelog: v0.4.2...v0.5.0

Full Changelog: v0.4.1...v0.4.2

Full Changelog: v0.4.0...v0.4.1

Added

• Update check: interactive runs query the npm registry at most once per day
  (in the background, result cached) and print a one-line notice to stderr when
  a newer release is available. It stays silent in non-interactive use (scripts,
  pipes, CI, --json) and can be disabled with CODEX_PROFILE_NO_UPDATE_CHECK
  or DO_NOT_TRACK. See README "Update Checks" and SECURITY.md "Network
  Activity".
• GitHub Actions workflow that publishes the codex-profile npm package on
  v* tag pushes (or manual dispatch), gated on make test and verifying the
  tag matches package.json, with npm provenance.
• Release-drift guard: make test now asserts that bin/codex-profile's
  VERSION matches package.json (which already had to match the docs
  softwareVersion), so a version bump can't ship a CLI that reports a stale
  version. Added doctor happy-path and upgrade missing-Makefile test cases.

Changed

• clone-config allowlist now matches current Codex instruction-file
  conventions: dropped the obsolete instructions.md and
  custom-instructions.md entries, leaving config.toml and the global
  AGENTS.md (Codex consolidated global user instructions onto AGENTS.md).
• app and app-instance now fail with a clear "only available on macOS"
  message on non-macOS systems instead of a Codex-path "not found" error.
• help is now listed in codex-profile help output, and the README
  Platform Support list includes version and help.

codex-profiles runs Codex CLI and Codex Desktop with isolated CODEX_HOME profiles. This release makes the project AI-native: any chatbot or coding agent can now answer "how do I run this?" directly.

✨ Highlights

• 🤖 Run It With an AI Assistant (README) — a ready-to-paste prompt for ChatGPT / Claude / Codex, plus an expandable copy-paste answer block with the canonical install + run commands and the facts an assistant must state accurately.
• AGENTS.md — the file Codex, Claude Code, and Cursor read automatically inside a clone: project overview, make test / make lint, how to run, change conventions, and safety boundaries.
• llms.txt — a numbered "How to run" answer template for AI assistants.
• Project page FAQ — added an AI-assistant question (JSON-LD + visible HTML in sync).

📦 Also in this line (since v0.2.0)

• Experimental app-instance command for parallel Codex Desktop profiles with isolated CODEX_HOME, Electron user data, and instance logs.
• logs <profile> --instance for reading app-instance logs.
• Published npm package metadata and install docs for codex-profile.
• GitHub Pages GEO documentation: JSON-LD, robots.txt, sitemap.xml, llms.txt, audit matrix, and measurement plan, with a Pages deploy workflow.

Install

npm install -g codex-profile
brew install Ducksss/tap/codex-profile
codex-profile doctor

Full notes: see CHANGELOG.md.

Added

• init command for explicit profile home creation.
• remove command with profile-name confirmation and --yes automation mode.
• logs command for printing, tailing, or locating profile-local desktop logs.
• clone-config command for copying known non-secret config files between
  profiles without copying auth, sessions, plugins, logs, or caches.
• status --json and doctor --json for script-friendly diagnostics.
• completions command for Bash, Zsh, and Fish completion generation.
• list command for read-only initialized profile discovery.
• version and --version output.
• upgrade command for source-style self-updates from the project git
  repository, including --dry-run, --prefix, --ref, unversioned-candidate
  refusal, older-version refusal, and branch, tag, or commit-SHA refs.

Changed

• Profile path mapping now treats only default as special. Every other valid
  name, including dev, main, and edu, maps directly to
  .codex-<profile>.
• All-profile status now skips invalid .codex-* directory names during
  discovery.
• doctor now accepts options and can emit machine-readable output.

Tests

• Added coverage for CLI/login argument pass-through, invalid profile names,
  direct profile-name path mapping, list output, version output, hardened
  status discovery, JSON diagnostics, profile lifecycle commands, log
  inspection, completion generation, source upgrades, dirty upgrade checkout
  protection, commit-SHA refs, unversioned-candidate refusal, older-version
  refusal, and safe config cloning.

Patch release with profile-switching hardening.\n\nFixes:\n- Waits for both the main Codex Desktop process and the bundled app-server process to stop before launching a new profile.\n- Fails loudly if profile directories cannot be made private.\n- Makes status read-only, so typos do not create stray profile homes.\n- Propagates unexpected Codex CLI status failures while treating Not logged in as a normal status result.\n\nCI: https://github.com/Ducksss/codex-profiles/actions/runs/24925336826

Initial public release of codex-profiles.\n\nHighlights:\n- Run Codex CLI and Codex Desktop with isolated CODEX_HOME profiles.\n- Avoid auth.json swapping while keeping profile setup simple.\n- Includes login, status, path, doctor, CLI, and desktop app commands.\n- Adds public CI across Ubuntu and macOS with ShellCheck and smoke tests.\n\nInstall:\nsh\ngit clone https://github.com/Ducksss/codex-profiles.git\ncd codex-profiles\nmake install\n