Skip to main content
Associate the current directory with an existing or new Alpic project. Once linked, commands like deploy and git connect operate on the linked project without requiring additional flags.

​
Usage

alpic link
Interactively links the current directory to an Alpic project. Prompts for project selection or creation if not already linked.

​
Extended Usage

Skip all prompts (useful in CI): 
alpic link --non-interactive --project-name my-app --runtime node24
Link to an existing project by ID: 
alpic link --project-id <projectId>
Create a new project whose app lives in a monorepo subdirectory (path is relative to the directory where you run the command): 
alpic link --project-name my-app --root-dir ./packages/my-mcp-server
When linking interactively, Root directory defaults to . (repository root). Alpic stores this path on the project so builds and deployments run from that folder inside the connected repository.

​
Options

FlagDescription
--non-interactiveSkip all confirmation prompts
--team-idTeam ID to use
--project-idLink to this existing project ID
--environment-idUse this environment ID
--project-nameNew project name
--runtimeRuntime to use: node24, node22, python3.14, python3.13
--root-dirRelative path to the app root for builds and deployments; only when creating a new project (omit for repository root)
Authentication is required. Run alpic login or set ALPIC_API_KEY before linking.
If the current directory is a git repository, link will offer to connect the project to a GitHub remote after linking.