Applications

List and create Gigadrive Network applications from the terminal with gigadrive apps.

A Gigadrive Network application owns its deployments and environment variables. gigadrive apps finds the ID of one you already have, or creates a new one before your first deploy.

Listing applications

gigadrive apps list prints every application the signed-in account can reach.

Flag	Alias	Description
`--org`	`-o`	Only list applications belonging to this organization ID

gigadrive apps list

0195c11c-0000-7000-8000-000000000042  Marketing site  (Gigadrive)
0195c11c-0000-7000-8000-000000000043  API  (Gigadrive)

2 application(s).

Each line is the application ID, the display name, then the owning organization in parentheses, with two spaces between fields. With nothing to show, the command prints No applications found.

Narrow the list when you belong to several organizations:

gigadrive apps list --org 0195c0aa-0000-7000-8000-0000000000ff

Applications come back in creation order, oldest first. The CLI sends no page size and never asks for a second page, so you see the API's default page of ten. The count on the last line covers every match, so 12 application(s). beneath ten rows is not a bug: the two newest applications fell off the end. --org is how you bring the set back under ten.

Creating an application

gigadrive apps create needs an organization and a name. The other two flags are optional.

Flag	Alias	Required	Description
`--org`	`-o`	Yes	Organization ID that will own the application
`--name`	`-n`	Yes	Application display name
`--slug`		No	Optional lowercase application slug
`--root-directory`		No	Optional project directory relative to the repository root

gigadrive apps create --org 0195c0aa-0000-7000-8000-0000000000ff --name "Marketing site"

Created application Marketing site (0195c11c-0000-7000-8000-000000000042).
Run "gigadrive link --app 0195c11c-0000-7000-8000-000000000042" to link the current directory.

The API trims whitespace from the name, and derives the slug from it when you leave --slug off.

--root-directory is the package to build inside a repository, given relative to the repository root. Redundant separators are normalized away; absolute paths and .. segments are rejected.

gigadrive apps create -o 0195c0aa-0000-7000-8000-0000000000ff -n "API" --slug api --root-directory apps/api

Creating an application does not point your working directory at it. Do that with the ID from the second output line, covered in Project linking.

You do not always need this command. Deploy creates and links an application by itself in an unlinked directory, naming it after the directory. Use apps create when you want to choose the slug or the root directory up front, which that path does not offer.