wojciech-kulik/xcodeprojectcli

A fast, lightweight command-line tool for managing Xcode projects, built entirely in Swift.

🚀 Features

OVERVIEW: XcodeProjectCLI

USAGE: xcp <subcommand>

OPTIONS:
  --version               Show the version.
  -h, --help              Show help information.

TARGET SUBCOMMANDS:
  list-targets            List project targets.
  set-target              Set target for existing file.

GROUP SUBCOMMANDS:
  add-group               Add group.
  delete-group            Delete group.
  move-group              Move group.
  rename-group            Rename group.

FILE SUBCOMMANDS:
  add-file                Add file to specified targets.
  delete-file             Delete file.
  move-file               Move file.
  rename-file             Rename file.

BUILD SETTINGS SUBCOMMANDS:
  get-build-setting       Get build setting.
  set-build-setting       Set build setting.

ASSETS SUBCOMMANDS:
  add-image-asset         Add image asset.
  add-data-asset          Add data asset.
  add-color-asset         Add color asset.
  list-assets             List all assets.
  move-asset              Move asset.
  delete-asset            Delete asset.

  See 'xcp help <subcommand>' for detailed help.

📦 Installation

brew install xcp

🛠️ Building from Source

Clone the repository.
Navigate to the project directory.
Build the project and install:

``bash make install ``

Verify the installation:

``bash xcp --version ``

⚙️ Use as a Library

You can also use XcodeProjectCLI as a library in your macOS Swift projects, enabling you to create your own automations.

Here's a simple example of how to integrate it:

import XcodeProject

let projectPath = "/path/to/YourProject.xcodeproj"
let xcodeProject = try Project(xcodeProjectPath: projectPath)

// Sample operation:
try project.groups.addGroup("path/relative/to/xcodeproj/NewGroup".asInputPath)
try project.save()

🤓 My Other Projects

Snippety - Snippets manager for macOS & iOS
FlashSpace - Fast virtual workspace manager for macOS
Smog Poland - Air quality monitoring app for Poland
xcodebuild.nvim - Neovim plugin for building Xcode projects

[xcodebuild.nvim]: https://github.com/wojciech-kulik/xcodebuild.nvim

Package Metadata

Repository: wojciech-kulik/xcodeprojectcli

Default branch: main

README: README.md