Maintainer of this skill?
by ferhatcore
Project management for Claude Code and Codex with shared task files, developer and QA roles, and human approvals.
# Add to your Claude Code skills
git clone https://github.com/ferhatcore/claude-codex-project-osGuides for using ai agents skills like claude-codex-project-os.
See how claude-codex-project-os compares with popular alternatives.
claude-codex-project-os is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ferhatcore. Project management for Claude Code and Codex with shared task files, developer and QA roles, and human approvals. It has 59 GitHub stars.
claude-codex-project-os's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/ferhatcore/claude-codex-project-os" and add it to your Claude Code skills directory (see the Installation section above).
claude-codex-project-os is primarily written in JavaScript. It is open-source under ferhatcore on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh claude-codex-project-os against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
See comparison
A project structure with task files, clear responsibilities and a separate QA step. Install it for Claude Code, Codex or both from this repository.
The PM keeps track of decisions, writes tasks and assigns work. A developer makes the change. QA checks the result against the task before it comes back for approval. Progress lives in files, so a new session can continue without starting the explanation again.
Both clients use the same planning directory, task files, decisions and repository rules. You can change clients between steps while keeping the project state in one place.
You need Node.js 22 or newer and the coding client you want to use. There are no npm packages to install.
git clone https://github.com/ferhatcore/claude-codex-project-os.git
cd claude-codex-project-os
For Claude Code:
node scripts/init.mjs --target ../claude-demo --example --runtime claude
For Codex:
node scripts/init.mjs --target ../codex-demo --example --runtime codex
For both clients in one workspace:
node scripts/init.mjs --target ../shared-demo --example --runtime both
Open the generated directory in your selected client and ask it to read START.md. In Codex you can also invoke $project-os-start.
The example is a local reading list called Trailboard, with a small CLI, a handbook and a proposed status filter task. Try it from the generated workspace:
node repos/catalog/catalog.mjs
node --test repos/catalog/catalog.test.mjs
For your own project, omit --example and set --name "My Project". The destination must be new. The installer leaves existing repositories and global client settings alone. Older install commands without --runtime continue to select Claude Code.
Quickstart covers the first session and connecting existing repositories.
Claude Code receives CLAUDE.md instructions. Codex receives AGENTS.md, project skills and four role definitions for PM, Developer, QA and Reviewer. Selecting both installs both entry points with one shared set of planning files.
Codex uses the available native delegation tools. If a client cannot select a named role directly, the PM sends that role's full instructions in the delegated brief. Manual sessions are the fallback. The installer itself does not start agents or make a model request.
The generated .project-os.json records the selected runtime, repository list, worker cap and model preferences. Choose lean, standard or heavy for the worker cap. Model tiers inherit the active model until you map them to settings available in your account.
flowchart LR
H[Human: scope and approval] --> PM[PM: task and plan]
PM --> D[Developer]
D --> S{Security review needed?}
S -->|yes| R[Security review]
S -->|no| Q[QA]
R -->|pass| Q
R -->|findings| D
Q -->|findings| D
Q -->|criteria pass| C[PM: check completeness]
C --> A[Human: approve Git actions]
A --> P[Separate deployment decision]
A task names its repository, scope, branch, acceptance criteria and permissions. The working session records what changed, what it checked and where to resume. QA verifies each criterion independently. If scope changes, the task changes first.
Security and QA share a limit of two failed review cycles. A third cycle needs a new plan and human approval. Only one writer works in a repository at a time, including when switching between Claude Code and Codex. Code approval does not also approve a commit, push or deployment.
node scripts/check.mjs
node --test scripts/system.test.mjs scripts/smoke.test.mjs scripts/runtimes.test.mjs
node --test examples/trailboard/repos/catalog/catalog.test.mjs
The checks cover all three runtime choices, all three worker profiles, shared task state, generated agent files, installation refusals, configuration and fixture behavior. GitHub Actions runs the suites on Windows and Linux with Node.js 22.
The Codex verification record lists the client sessions, task results and remaining limits.
MIT. Copyright (c) 2026 Ferhat Kosger.
An independent project for Claude Code and Codex.