26.2 26.1
26.2 26.1

Command Reference

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.

Syntax and Common Options

All commands use the following form:

pas <command> [options] [arguments]

Option

Description

-V, --version

Prints the version of the CLI. Use it directly after pas.

-h, --help

Prints the help for the CLI. Place it after a command to print the help for that command, for example pas new --help.

--verbose

Prints detailed output, for example the output of the work a command runs and what the platform or Git reported. Default: off. The option is available for every command except pas info, pas platform list, and pas platform git authorize.

Arguments follow these rules:

  • An argument in angle brackets, for example <name>, is required. If you omit it, the CLI prompts you for the value.

  • An argument in square brackets, for example [alias], is optional. When you omit it, the CLI offers you a selection list.

Subcommands

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]

Platform Information Commands

The commands pas platform gateway info, pas platform iam info, and pas platform mcp info print what the configuration of the active platform states about one part of that platform. The following applies to all three commands:

  • They require an active platform.

  • They also work when your session has expired.

  • They print one line per value, in the form <label>: <value>, to the standard output. Messages and errors go to the standard error.

  • The output contains no token, no client secret, and no other credential.

  • The values come from the configuration of the platform that pas platform login reads.

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 the platform. 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 gateway info

Prints the address at which the Agent Gateway of the active platform serves a large language model (LLM) provider. The address contains two placeholders: <platform> for the platform prefix and <provider> for the name of the LLM provider. Example output:

Agent Gateway Provider URL:  https://staging-agentgateway.pascode.pas-internal.com/<platform>/llm/<provider>

If the configuration of the platform states no address of the Agent Gateway, the command fails and names pas.agent-gateway.client. Refer to Agent Gateway for the LLM providers and virtual API keys of the Agent Gateway.

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.

pas platform iam info

Prints the discovery URL of the identity provider of the active platform. This is the address where the identity provider publishes its own description. Example output:

IAM Discovery URL:  https://staging.k8s.pas-internal.com/sso/realms/pas

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 mcp info

Prints what a Model Context Protocol (MCP) client, for example an AI coding assistant, needs to reach the platform MCP server of the active platform. Example output:

Transport:  streamable-http
URL:        https://staging-agentgateway.pascode.pas-internal.com/hub/mcp
Client ID:  mcp-client

When the platform states no client, the Client ID line is left out. If the configuration of the platform states no address of the platform MCP server, the command fails and names pas.platform-mcp.client. Refer to Connecting to the Platform MCP Server for details.

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.

On Windows, the command turns off the Nx terminal UI (NX_TUI=false) unless you set NX_TUI yourself.


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.

pas update

Shows the installed version and the latest release.

  • When a newer release exists, the CLI asks the user to confirm the update. When the user confirms, the CLI installs the release globally with npm.

  • When the latest release is already installed, or when the installed version is newer (e.g. an alpha version), the CLI installs nothing.

Updating the PAS CLI does not update already created projects. After the update, only newly created projects will have access to the newest features.


-y, --yes

Installs the latest release without the question.

📗