# Setup Project

> Use when you need the Codex Copilot equivalent of Claude Copilot /setup-project: wire a target repository to the shared Codex Copilot framework.

- Skill: `everyone-needs-a-copilot/setup-project` (Agent Skill)
- Install (CLI): `npx skillmds@latest add everyone-needs-a-copilot/setup-project`
- Raw SKILL.md: https://api.skillmd.com/api/skills/everyone-needs-a-copilot/setup-project/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Everyone-Needs-A-Copilot (https://skillmd.com/u/everyone-needs-a-copilot)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/everyone-needs-a-copilot/setup-project

---


# Setup Project

Wire a project to Codex Copilot.

## Workflow

1. Use `scripts/setup-project.sh --project <path>` from the framework repo. Safe to re-run: if the project already has a codex-copilot install, this delegates to `scripts/update-project.sh` to repair the plugin/skill/QA-gate paths in place instead of refusing.
2. Treat `--force` as compatibility-only; it changes nothing (there is no longer a refusal to bypass).
3. Verify generated `AGENTS.md`, `.agents/plugins/marketplace.json`, `.claude/cc/config.json`, memory dirs, plugin links, `docs/40-initiatives/`, and the `scripts/copilot-gate.sh` link.
4. Confirm existing `AGENTS.md`, initiative documentation, and any file marked `owner: project` were preserved rather than replaced.
5. Run `cc skill list`, `cc docs sources`, `cc memory check --json`, `tc progress --json`, and `scripts/copilot-gate.sh` from the target project when available.
6. If wiring already exists and you only want a refresh (no first-install scaffolding), use `$update-project` / `scripts/update-project.sh` directly.

## Output

- generated files
- plugin and skill link targets
- verification results