manipulate-xcodeproj

Original：🇺🇸 English

Translated

Manipulate Xcode projects and asset catalogs using XcodeProjectCLI (xcp) only. Use when editing .xcodeproj/.pbxproj files, adding/moving/renaming/deleting groups or files, changing target membership, reading or setting build settings, or managing xcassets assets.

1installs

Sourcekhoi/skills

Added on2026-02-14

NPX Install

npx skill4agent add khoi/skills manipulate-xcodeproj

SKILL.md Content

View Translation Comparison →

Manipulate Xcodeproj

Overview

Use

xcp

for all project edits and asset catalog operations. Install it with

brew install xcp

if it is not already available.

Workflow

Identify the
```
.xcodeproj
```
or
```
.xcassets
```
path.
For target-specific actions, run
```
xcp list-targets
```
first.
Run the appropriate
```
xcp
```
subcommand. Use
```
--project-only
```
to update the project file without touching the filesystem.
Re-run
```
xcp list-targets
```
or
```
xcp list-assets
```
if you need to verify results.

Tasks

Project structure

Use group and file subcommands to add, move, rename, or delete entries. Use

--create-groups

when adding and

--guess-target

when you want the tool to infer targets for a new file.

Targets and build settings

Use

list-targets

to discover names,

set-target

to update file memberships, and build-setting commands to read or update configuration values.

Asset catalogs

Operate on

.xcassets

directories directly for image, data, and color assets. Paths are relative to the

.xcassets

root.

References

Command and flag reference:
```
references/xcp-cli.md
```
For flags and usage specifics, prefer
```
xcp help <subcommand>
```
as the source of truth.