# Install xcp with Homebrew, Nix Fast & lightweight command-line tool for managing Xcode projects, built in Swift. Version 1.2.1 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:xcp ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install xcp ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#xcp ``` Evidence: nixpkgs package indexes: pkgs/by-name/xc/xcp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:xcp - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.2.1 - **Source summary:** Fast & lightweight command-line tool for managing Xcode projects, built in Swift - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - xcp (cli) - xcp (alias) ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.2.1 - Local data: ok - Upstream repository: https://github.com/wojciech-kulik/XcodeProjectCLI - Upstream latest detected: v1.2.1 (current) - info: No package-manager update timestamp was available. ## Project history and usage XcodeProjectCLI, installed as xcp, is a Swift command-line and library wrapper for making targeted edits to Xcode project files. It focuses on direct project maintenance tasks such as listing targets, moving groups and files, changing build settings, and managing asset catalog entries. ### Project history The GitHub repository was created on 2025-10-28, with the first public release, v0.9.1, published on 2025-10-30 and v1.0.0 following on 2025-11-14. The README describes the project as a fast, lightweight CLI for managing Xcode projects, built entirely in Swift and powered by Tuist's XcodeProj library. The author announced the tool on the Swift Forums in November 2025, explaining that it was initially built for the xcodebuild.nvim Neovim plugin but could be used generally to automate Xcode project-file work. The v1.0.0 release added support for relative .xcodeproj paths and build-setting get/set commands, moving the tool from basic structure manipulation toward broader project automation. ### Adoption history Because xcp is newer and narrower than XcodeGen or xcodes, its adoption history is still early. Its visible niche is automation around existing .xcodeproj files, especially editor and scripting workflows where opening Xcode just to add a file, move a group, or tweak a build setting is unnecessary. ### How it is used Typical CLI usage calls xcp with subcommands for targets, groups, files, build settings, and assets. The same code can also be used as a Swift library, allowing macOS automation tools to open a project, manipulate groups or files, and save the pbxproj programmatically. Compared with generators, xcp does not replace the .xcodeproj with a declarative spec. Its niche is smaller: script one operation against an existing project file, which is useful for editor integrations, refactoring scripts, and generated-file workflows. ### Why package nerds care xcp is significant as a small composable Unix-style tool for an otherwise GUI-heavy file format. For package catalogues it sits between low-level pbxproj libraries and high-level project generators: one executable, a focused command set, and an automation-friendly Swift library underneath. ### Timeline - 2025-10-28: Repository created on GitHub. - 2025-10-30: v0.9.1 first public release. - 2025-11-14: v1.0.0 release added relative project paths and build-setting commands. - 2025-11-19: Author presented XcodeProjectCLI in the Swift Forums Community Showcase. - 2025-11-22: v1.2.1 release published. ### Related projects - XcodeProj from Tuist is the underlying library named by the README as the foundation for XcodeProjectCLI. - xcodebuild.nvim is related because the author said xcp was initially built for that Neovim-based iOS/macOS development workflow. ### Sources - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** xcp - **Version Scheme:** 0 - **Revision:** 0 - **Requirements:** macos, xcode - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - xcp: normalized package name match | nixpkgs package indexes: pkgs/by-name/xc/xcp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [xcsift](https://www.automicvault.com/pkg/brew/xcsift/) - Shares av.db curated category or tags: cli, developer-tools, mobile, swift, xcode. - [unxip](https://www.automicvault.com/pkg/brew/unxip/) - Shares av.db curated category or tags: cli, developer-tools, swift, xcode. - [kin](https://www.automicvault.com/pkg/brew/kin/) - Shares av.db curated category or tags: cli, developer-tools, xcode. - [xcresultparser](https://www.automicvault.com/pkg/brew/xcresultparser/) - Shares av.db curated category or tags: cli, developer-tools, mobile, xcode. - [adb-enhanced](https://www.automicvault.com/pkg/brew/adb-enhanced/) - Shares av.db curated category or tags: cli, developer-tools, mobile. - [configen](https://www.automicvault.com/pkg/brew/configen/) - Shares av.db curated category or tags: cli, developer-tools, swift, xcode. - [cyan](https://www.automicvault.com/pkg/brew/cyan/) - Shares av.db curated category or tags: cli, developer-tools, mobile. - [flank](https://www.automicvault.com/pkg/brew/flank/) - Shares av.db curated category or tags: cli, developer-tools, mobile. - [ios-sim](https://www.automicvault.com/pkg/brew/ios-sim/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, line. ## Combined YAML source View the package source record on GitHub. [combined/xcp.yml](https://github.com/automic-vault/db/blob/main/combined/xcp.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph