CloneCommand CLI

The CloneCommand CLI (clones) provides developer utilities for managing projects and services in the CloneCommand ecosystem.

Installation

npm install -g @clonecommand/cli

Usage

1. Authentication

Log in to your CloneCommand account:

clones auth login

Check your current status:

clones auth whoami

Log out:

clones auth logout

2. Project Initialization

Initialize a project in the current directory:

clones project init

This will create a ccproject.json file in the current directory.

3. Service Initialization

Initialize a service in a subdirectory (must contain a Dockerfile):

clones service init

This will create a ccservice.json file in the current directory, linking it to your project.

4. Running Commands

Run your application with environment variables automatically injected for the current git branch:

clones run npm run dev

Debugging & Tips

Check Injected Variables

To see exactly which environment variables are being injected into your process, run:

clones run env

This is useful for verifying that secrets and service URLs are correctly resolved for your current branch.

Integration with Scripts

You can make your development workflow seamless by prepending clones run to your scripts in package.json:

"scripts": {
  "dev": "clones run npm run start:dev"
}

This ensures that whenever you run npm run dev, your environment is automatically correctly configured.