Commands

You use the command line tool of PAS Code (PAS CLI) to create a PAS Code project, to add components such as apps, services, and agents to that project, and to run the project locally.

Every action of the CLI is a command. You call a command through the pas executable, followed by the command name and its arguments:

pas <command> [arguments] [options]

Some commands group related subcommands. For grouping commands such as pas platform and pas generate, you always call one of their subcommands, for example pas platform login or pas generate app.

If you did not install the CLI globally, call any command through npx instead:

npx -y @pas/cli <command> [arguments] [options]

Arguments in angle brackets, for example <name>, are required. When you omit a required argument, the CLI asks you for the value. Arguments in square brackets, for example [alias], are optional. When you omit them, the CLI offers you a selection list.

Every command supports --help to print its arguments and options, and --verbose to print the detailed output of the processes the command starts.
Use pas --version to print the installed CLI version.

Command Reference

Commands and Options

Description

pas generate


Groups the commands that generate PAS components into an existing project. Call one of its subcommands.


pas generate agent <name>

Generates an AI agent inside an existing service.


--directory <path>

Sets the target directory. When you omit it, the command lists the services of the project and asks for the directory inside the selected service.

pas generate app <name>

Generates an Angular frontend application in packages/<name>.


--e2e-test-runner <runner>

Adds end-to-end tests with playwright or cypress (default none)

--skip-format

Leaves the generated code unformatted.

pas generate bundle <name>

Generates a project bundle in packages/<name>. A project bundle groups apps and services that are deployed together.


--skip-deployment-config

Omits the bundle-wide deployment configuration file.

--skip-format

Leaves the generated code unformatted.

pas generate service <name>

Generates a NestJS backend service in packages/<name>.



--e2e-test-runner jest

Adds end-to-end tests.


--include-agent <agent-name

Generates an AI agent together with the service.


--skip-format

Leaves the generated code unformatted.

pas info

Prints information about the installed CLI. Use it to check that the CLI is installed and callable.

pas new <project-name>

Creates a new PAS Code project in a directory named after the project. The command asks whether a matching repository is created on the active platform, and logs you in first when no platform is active. Example components are included by default.


--skip-example

Creates an empty project (without example components).

--skip-format

Leaves the generated code unformatted.

pas platform


Groups the commands that manage the connections to your Scheer PAS platforms. Call one of its subcommands.


pas platform delete [alias]

Deletes a stored platform connection from your computer. When you omit the alias, the command asks you to select one.

pas platform git

Groups the commands that manage your access to the Git service of the active platform. Call one of its subcommands.

pas platform git add-ssh [ssh-key-path]

Registers the SSH public key of your computer in the Git service of the active platform, so you can push to its repositories. When you omit the path, the command lists the keys in ~/.ssh and offers to create a key when none exists. Pass the public key file ending in .pub, not the private key.

pas platform git authorize

Opens your browser to authorize your user for the Git service of the active platform. Run this command when another Git command reports that the Git service is not authorized.

pas platform git create-repository <name>

Creates a repository with the given name on the active platform, adds it as the Git remote origin of the current directory, and pushes the current branch with upstream tracking. When the push fails because no SSH key is registered, the command registers your key and repeats the push once.

pas platform list

Lists the platform connections stored on your computer with their URLs and marks the active one.

pas platform login <platform-url>

Authenticates you against the platform at the given URL. The command opens your browser for the login, stores the credentials on your computer, activates the platform, and registers your SSH key in the Git service of the platform.


--alias <alias>

Gives the connection a short name. Without an alias, the platform URL is used.

pas platform use [alias]

Activates a stored platform connection, so subsequent commands work against that platform. When you omit the alias, the command asks you to select one from the stored connections.

pas start

Starts the current project locally with npm run start.


P, --profile <profile>

Switches the Kubernetes context to the cluster of the profile and starts Tilt instead, which runs the project on that cluster.

Profiles are stored as JSON files in ~/.pas/profiles.

📗