codevsfp CLIsfp serverlibraries

Project

Register and configure projects

sfp server project create

Onboard a repository to the SFP server (requires owner role)

USAGE
  $ sfp server project create -r <value> -u <value> [--json] [-e <value>] [-t <value>] [--sfp-server-url <value>] [-g
    <value>...] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]

FLAGS
  -e, --email=<value>               Email address for authenticated user. Ignored if --application-token is provided.
                                    Can be set via SFP_SERVER_USER env var.
  -g, --logsgroupsymbol=<value>...  Symbol used by CICD platform to group/collapse logs in the console. Provide an
                                    opening group, and an optional closing group symbol.
  -r, --repository=<value>          (required) Repository identifier (e.g., owner/repo for GitHub/GitLab or
                                    org/project/repo for Azure DevOps)
  -t, --application-token=<value>   Application token for CI/CD authentication. Can be set via SFP_SERVER_TOKEN env var
                                    (CLI flags take precedence over env vars).
  -u, --remote-url=<value>          (required) Remote repository URL
      --loglevel=<option>           [default: info] logging level for this command invocation
                                    <options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
      --sfp-server-url=<value>      URL of the SFP server. Can be set via SFP_SERVER_URL env var or config: sfp
                                    config:set server-url

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Onboard a repository to the SFP server (requires owner role)

EXAMPLES
  $ sfp server project create --repository flxbl-io/sf-core --remote-url https://github.com/flxbl-io/sf-core

  $ sfp server project create --repository 12345 --remote-url https://gitlab.com/myorg/myproject

See code: src/commands/server/project/create.ts

sfp server project get

Get details of a specific project from the SFP server

USAGE
  $ sfp server project get -r <value> [--json] [-e <value>] [-t <value>] [--sfp-server-url <value>] [-g <value>...]
    [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL] [-p <value>] [-b]

FLAGS
  -b, --branches                    Output branches only (for CI/CD)
  -e, --email=<value>               Email address for authenticated user. Ignored if --application-token is provided.
                                    Can be set via SFP_SERVER_USER env var.
  -g, --logsgroupsymbol=<value>...  Symbol used by CICD platform to group/collapse logs in the console. Provide an
                                    opening group, and an optional closing group symbol.
  -p, --property=<value>            Extract a specific property using dot notation (e.g., "remoteUrl" or
                                    "configuration.domains.sales.releaseName")
  -r, --repository=<value>          (required) Repository identifier (e.g., owner/repo for GitHub/GitLab or
                                    org/project/repo for Azure DevOps)
  -t, --application-token=<value>   Application token for CI/CD authentication. Can be set via SFP_SERVER_TOKEN env var
                                    (CLI flags take precedence over env vars).
      --loglevel=<option>           [default: info] logging level for this command invocation
                                    <options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
      --sfp-server-url=<value>      URL of the SFP server. Can be set via SFP_SERVER_URL env var or config: sfp
                                    config:set server-url

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Get details of a specific project from the SFP server

EXAMPLES
  $ sfp server project get --repository flxbl-io/sf-core

  $ sfp server project get --repository flxbl-io/sf-core --json

  $ sfp server project get -r flxbl-io/sf-core -p remoteUrl

  $ sfp server project get -r flxbl-io/sf-core -p configuration.displayName

  $ sfp server project get -r flxbl-io/sf-core -p "configuration.domains.sales.releaseName"

  $ sfp server project get -r flxbl-io/sf-core -p "configuration.settings[0]" --json

  $ sfp server project get -r flxbl-io/sf-core --branches  # Output branches only for CI/CD

See code: src/commands/server/project/get.ts

sfp server project list

List all onboarded projects in the SFP server

USAGE
  $ sfp server project list [--json] [-r <value>] [-e <value>] [-t <value>] [--sfp-server-url <value>] [-g <value>...]
    [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL] [-p github|gitlab|bitbucket|other]
    [-b]

FLAGS
  -b, --branches                    Output branches only (for CI/CD). Requires --repository flag.
  -e, --email=<value>               Email address for authenticated user. Ignored if --application-token is provided.
                                    Can be set via SFP_SERVER_USER env var.
  -g, --logsgroupsymbol=<value>...  Symbol used by CICD platform to group/collapse logs in the console. Provide an
                                    opening group, and an optional closing group symbol.
  -p, --platform=<option>           Filter by platform
                                    <options: github|gitlab|bitbucket|other>
  -r, --repository=<value>          Filter by repository identifier (e.g., owner/repo for GitHub/GitLab or
                                    org/project/repo for Azure DevOps)
  -t, --application-token=<value>   Application token for CI/CD authentication. Can be set via SFP_SERVER_TOKEN env var
                                    (CLI flags take precedence over env vars).
      --loglevel=<option>           [default: info] logging level for this command invocation
                                    <options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
      --sfp-server-url=<value>      URL of the SFP server. Can be set via SFP_SERVER_URL env var or config: sfp
                                    config:set server-url

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List all onboarded projects in the SFP server

EXAMPLES
  $ sfp server project list

  $ sfp server project list --json

  $ sfp server project list --repository flxbl-io/sf-core

  $ sfp server project list --repository flxbl-io/sf-core --branches  # Output branches only

  $ sfp server project list --platform github

See code: src/commands/server/project/list.ts

sfp server project update

Update a project property in the SFP server

USAGE
  $ sfp server project update -r <value> [--json] [-e <value>] [-t <value>] [--sfp-server-url <value>] [-g <value>...]
    [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL] [-p <value>] [-v <value>] [-b
    <value>] [--replace] [--version <value>]

FLAGS
  -b, --branches=<value>            Comma-separated list of branches to set (e.g., "main,develop,release/*")
  -e, --email=<value>               Email address for authenticated user. Ignored if --application-token is provided.
                                    Can be set via SFP_SERVER_USER env var.
  -g, --logsgroupsymbol=<value>...  Symbol used by CICD platform to group/collapse logs in the console. Provide an
                                    opening group, and an optional closing group symbol.
  -p, --property=<value>            Property path to update using dot notation (e.g., "configuration.domains.sales")
  -r, --repository=<value>          (required) Repository identifier (e.g., owner/repo for GitHub/GitLab or
                                    org/project/repo for Azure DevOps)
  -t, --application-token=<value>   Application token for CI/CD authentication. Can be set via SFP_SERVER_TOKEN env var
                                    (CLI flags take precedence over env vars).
  -v, --value=<value>               New value for the property (can be JSON string for objects/arrays)
      --loglevel=<option>           [default: info] logging level for this command invocation
                                    <options: trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL>
      --replace                     Replace the entire value instead of merging (for objects)
      --sfp-server-url=<value>      URL of the SFP server. Can be set via SFP_SERVER_URL env var or config: sfp
                                    config:set server-url
      --version=<value>             Project version for optimistic concurrency control

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Update a project property in the SFP server

EXAMPLES
  # Update branches (convenient shorthand)

  $ sfp server project update -r flxbl-io/sf-core --branches main,develop,release/*



  # Update a simple property

  $ sfp server project update -r flxbl-io/sf-core -p remoteUrl -v "https://github.com/flxbl-io/sf-core-new"



  # Set a nested property

  $ sfp server project update -r flxbl-io/sf-core -p configuration.displayName -v "SFP Core Project"



  # Set a complex nested object (JSON string)

  $ sfp server project update -r flxbl-io/sf-core -p configuration.domains.sales \

    -v '{"releaseName": "sales-v2.1", "releaseConfig": "config/release-sales.yaml"}'



  # Set an array

  $ sfp server project update -r flxbl-io/sf-core -p configuration.tags \

    -v '["production", "critical", "salesforce"]'



  # Update multiple nested properties in one go

  $ sfp server project update -r flxbl-io/sf-core -p configuration.settings \

    -v '{"buildTimeout": 3600, "parallelBuilds": 4, "enableCache": true}'



  # Merge with existing configuration (default behavior)

  $ sfp server project update -r flxbl-io/sf-core -p configuration \

    -v '{"newField": "value", "settings": {"newSetting": true}}'



  # Replace entire configuration (use --replace flag)

  $ sfp server project update -r flxbl-io/sf-core -p configuration \

    -v '{"displayName": "New Config"}'

    --replace

See code: src/commands/server/project/update.ts

On this page