Skip to main content

Projects

This page describes all commands available in the Nestbox AI CLI for managing project configuration. Projects define the default context used for most CLI operations, such as deploying agents or managing compute instances.

List Projects​

List all available projects:

nestbox project list

Shows all projects from the API with their names, aliases (if any), and indicates which is the current default project.

Set Active Project​

Use this command to define which project the CLI should use by default:

nestbox project use <project-name>

Parameters:

  • <project-name> – Name of the project to set as default

Example:

nestbox project use my-ai-project

Add a Project​

Add a project with an optional alias:

nestbox project add <project-name> [alias]

Parameters:

  • <project-name> – Name of the project to add
  • [alias] – Optional alias for the project

Example:

nestbox project add my-ai-project myproj

How Project Context Is Used​

When a command requires a project context, the CLI will look for a .nestboxrc file in the current directory or parent directories. If no project is configured and none is specified via --project, the CLI will display an error.

You can always override the default by passing a specific project ID:

nestbox agent deploy --agent <agent-name> --project my-project