> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compozy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Project Management

> Learn how to effectively manage your Compozy projects using the CLI.

The Compozy CLI provides essential commands for managing your AI workflow projects. For detailed CLI features and commands, see our [CLI Overview](/cli/overview).

## Quick Installation

Install the Compozy CLI using your preferred package manager:

<CodeGroup>
  ```bash npm theme={"dark"}
  # Using npm (recommended for Node.js users)
  npm install -g @compozy/cli
  ```

  ```bash brew theme={"dark"}
  # macOS via Homebrew
  brew install compozy
  ```

  ```bash pacman theme={"dark"}
  # Arch Linux and derivatives
  sudo pacman -S compozy-cli
  ```

  ```bash cargo theme={"dark"}
  # Cross-platform installation via Rust
  cargo install compozy-cli
  ```
</CodeGroup>

## Project Configuration

Every Compozy project uses a `compozy.yaml` configuration file to define its structure, dependencies, and settings. For detailed configuration options and examples, see our [Project Configuration Guide](/cli/project-configuration).

## Development Workflow

<Steps>
  <Step title="Initialize a Project" icon="folder-plus">
    Create a new Compozy project:

    ```bash theme={"dark"}
    compozy init my-project
    ```
  </Step>

  <Step title="Configure Settings" icon="gear">
    Edit your `compozy.yaml` to set up dependencies and configurations. See our [Configuration Guide](/cli/project-configuration) for details.
  </Step>

  <Step title="Development" icon="code">
    Start the development server for local testing:

    ```bash theme={"dark"}
    compozy dev
    ```
  </Step>

  <Step title="Deploy" icon="rocket">
    Deploy your project to production:

    ```bash theme={"dark"}
    compozy deploy
    ```

    For deployment options, check our [Deployment Guide](/deployment/overview).
  </Step>
</Steps>

## Need Help?

* Run `compozy --help` for command information
* Join our [Discord community](https://discord.gg/compozy)
* Browse our [documentation](/core/base-structure/overview)
* Report issues on [GitHub](https://github.com/compozy/cli)