Learn how to install, activate, and use CodexFlow.
CodexFlow is a repo-native workflow OS for developers using OpenAI Codex. These docs explain how the product works, what gets installed, how paid activation works, and how to use CodexFlow safely in real repositories.
CodexFlow is independent and is not affiliated with, endorsed by, or sponsored by OpenAI.
Start here
Install / Getting Started
Activate a paid license, install the paid Individual payload, emit the repo workflow layer, and verify the setup.
What Gets Installed
Understand the workflow files CodexFlow adds to your repo: AGENTS.md, repo memory, skills, commands, QA guardrails, runbooks, handoff templates, and paid payload files.
Pricing
Compare Personal, Standard / Commercial Solo, and Team waitlist licensing. See what each tier includes and which license rights apply.
License Summary
Understand Personal vs Standard, commercial-use boundaries, single-user rules, redistribution restrictions, and paid payload rights.
Core concepts
Repo memory
Repo memory keeps durable project context in the repository. It helps Codex and humans preserve decisions, known issues, prompt logs, and handoffs across sessions.
Best used for:
- Project context
- Technical decisions
- Known risks
- Work logs
- Follow-up tasks
- Session handoffs
AGENTS.md
AGENTS.md gives Codex project-level operating instructions. It should explain how the repo works, what conventions matter, how to edit safely, and how to finish work properly.
Best used for:
- Repo rules
- Branch discipline
- Sensitive files
- Testing expectations
- Review expectations
- Definition of done
Skills
Skills are specialist workflows that help Codex handle repeatable tasks with better structure.
Best used for:
- Performance work
- SEO work
- Security review
- Supabase projects
- Vercel deployment debugging
- React refactors
- Test planning
- Release preparation
Commands
Commands turn repeated development rituals into reusable prompts and procedures.
Best used for:
- Planning a task
- Implementing a feature
- Reviewing changes
- Preparing a release
- Creating a handoff
- Running a focused audit
QA guardrails
QA guardrails help make AI-assisted changes more reviewable and less chaotic.
Best used for:
- Dry-runs
- Backups
- Risky-file review
- Test plans
- Validation checklists
- Safe write boundaries
Runbooks
Runbooks provide known-good procedures for common development and operational scenarios.
Best used for:
- CI repair
- Incident debugging
- Deployment troubleshooting
- Release checks
- Audit workflows
- Production-readiness review
Paid activation
Paid Personal and Standard customers receive a signed activation file and signed paid Individual payload access.
The paid setup flow is:
- Purchase Personal or Standard.
- Receive secure access to activation and payload materials after verified fulfillment.
- Activate the signed license file.
- Install the paid payload from the signed manifest and verified archive.
- Emit the paid workflow layer.
- Review the Git diff.
Personal and Standard receive the same paid Individual payload. The license rights are different.
- Personal: one individual, non-commercial use.
- Standard / Commercial Solo: one individual, commercial solo use allowed.
Security and privacy basics
CodexFlow is local-first workflow tooling.
Core principles:
- Workflow files live in your repository.
- Generated files are human-readable.
- Git is the review boundary.
- Paid payloads use signed manifests and verified archives.
- Activation files are signed.
- Premium output is watermarked without exposing raw secrets.
- The CLI does not transmit usage telemetry in this release.
- The website records operational data needed for orders, fulfillment, access, support, fraud prevention, and dispute evidence.
Practical workflow
A strong CodexFlow workflow looks like this:
- Start on a clean branch.
- Ask Codex to read AGENTS.md and relevant repo memory.
- Pick the command, skill, or runbook that matches the task.
- Ask for a plan before edits.
- Review risky areas before write operations.
- Run tests and checks.
- Update handoff notes.
- Commit a clean diff.
CodexFlow improves the operating structure around Codex. It does not remove the need to review and test code.
Troubleshooting shortcuts
I do not see paid content
Run:
codexflow license statusA valid paid activation and installed paid payload are required before paid workflow files can be emitted.
My activation file is rejected
Download it again from your secure access flow or contact support. Modified, expired, or incorrectly signed activation files are rejected.
I want to remove paid payload files
Run:
codexflow payload removeThen review the Git diff.
I want to uninstall CodexFlow
Run:
codexflow uninstall --yesCodexFlow preserves repo memory by default to reduce the risk of accidental context loss.
Reference pages
Recommended next read
If you are new to CodexFlow, read these in order:
You've seen the model. Add the paid CodexFlow workflow to your repo.
Install once. Improve every Codex session.
Choose a paid license, install the signed payload, and give every Codex session a structured repo workflow.
CodexFlow is independent and is not affiliated with, endorsed by, or sponsored by OpenAI.