change-directory

Learn how to change the working directory.

This action sets the working directory for all actions that follow.

This is helpful when your workflow moves into a different folder, such as after scaffolding a project inside a subdirectory. For example, if you run execute-package to clone a starter template into a new folder, you can switch into that folder before executing install or any additional setup steps.

Example

The following template scaffolds a project and then changes into it:

template.json5
{  "$schema": "https://schema.croct.com/json/v1/template.json",  "title": "Project scaffold",  "description": "Creates a project and switches to its directory.",  "actions": [    {      "name": "execute-package",      "command": "giget@latest",      "arguments": ["gh:user/starter", "my-project"]    },    {      "name": "change-directory",      "path": "my-project"    },    {      "name": "install"    },    {      "name": "print",      "semantics": "success",      "message": "Project ready."    }  ]}

To apply this template, run:

npx croct@latest use template.json5

Properties

These are the supported properties:

name
string

The action identifier. Always change-directory for this action.

path
string

The path to the new working directory.

Can be relative or absolute.