lizard init

Create or select a project and link it to the current directory.

Usage

lizard init [flags]

Flags

Examples

Link the current directory interactively

lizard init

Without --name, init asks which project to use. In a non-interactive shell it fails instead, so pass --name.

Link explicitly in CI

An unlinked lizard up deploys into your account’s default project. To deploy into a named project in CI, link it first:

export LIZARD_TOKEN=liz_xxx
lizard init --name my-project
lizard up --ci --service api   # creates api on the first run

Relink a directory that’s already linked

lizard init --name my-project --force

See also

• lizard link — associate the current directory with an existing project instead of creating one
• lizard status — show the linked workspace, project, and service for the current directory
• lizard up — upload and deploy the current directory
• Core Concepts — projects, services, and the build pipeline

Updated October 21, 2026