Alpic Docs

Installing Alpic CLI

Install the CLI globally with npm or pnpm:

npm install -g alpic
# or
pnpm add -g alpic

Run it without installing via npx:

npx alpic <command>

Authentication

The CLI supports two authentication methods: browser-based login and API key.

alpic login

Opens a browser window to authenticate. Tokens are stored locally and reused across sessions.

API key

Set the ALPIC_API_KEY environment variable to authenticate without a browser:

Get your API key

In the Alpic dashboard, open your team and go to API Keys in the sidebar. Click New API key, name it, and copy the key.

Set the environment variable

Export the key in your shell or add it to your CI/CD secrets:

export ALPIC_API_KEY=your_api_key_here

If both OAuth login credentials and ALPIC_API_KEY are present, the CLI uses ALPIC_API_KEY.

Keep your API key secure and never commit it to version control. If exposed, revoke it in the dashboard and create a new one.

Checking the version

alpic --version

Prints the installed CLI version.

Available Commands

Command	What it does	Full reference
`team list`	List teams for the current user	View docs
`team inspect`	Show details of a team and its projects	View docs
`project list`	List projects	View docs
`project inspect`	Show details of a project and its environments	View docs
`environment list`	List environments for a project	View docs
`environment inspect`	Show details of an environment	View docs
`environment delete`	Delete an environment	View docs
`audit`	Run a beacon audit on an MCP server	View docs
`link`	Link the current directory to an Alpic project	View docs
`deploy`	Deploy a project from the current directory or a specified path	View docs
`publish`	Publish an MCP server to the MCP registry	View docs
`deployment list`	List deployments for the current project	View docs
`deployment inspect`	Show details of a specific deployment	View docs
`deployment logs`	Retrieve build logs for a deployment	View docs
`login`	Authenticate via browser OAuth	View docs
`logout`	Remove stored OAuth credentials	View docs
`whoami`	Show the current authenticated identity	View docs
`logs`	Stream runtime logs for an Alpic environment	View docs
`insights intent list`	List grouped user intents for an environment	View docs
`insights feedback list`	List user feedback for an environment	View docs
`insights category list`	List intent categories for an environment	View docs
`insights category create`	Create an intent category	View docs
`insights category update`	Rename or recolor an intent category	View docs
`insights category delete`	Delete an intent category	View docs
`insights category link`	Link an intent category to intents	View docs
`insights category unlink`	Unlink an intent category from intents	View docs
`git connect`	Link a project to a git remote repository	View docs
`git disconnect`	Unlink a project from its git remote repository	View docs
`environment-variable add`	Add one or more environment variables to an Alpic environment	View docs
`environment-variable list`	List all environment variables for an Alpic environment	View docs
`environment-variable remove`	Remove an environment variable from an Alpic environment	View docs
`environment-variable update`	Update the value and/or secret status of an existing environment variable	View docs
`playground enable`	Enable the playground for an environment	View docs
`playground disable`	Disable the playground for an environment	View docs
`playground status`	Show playground configuration for an environment	View docs
`playground configure`	Set the playground server name and description	View docs
`playground example-prompt add`	Add an example prompt to the playground (max 5)	View docs
`playground example-prompt list`	List playground example prompts for an environment	View docs
`playground example-prompt remove`	Remove an example prompt from the playground	View docs
`playground headers add`	Add a header to the playground configuration	View docs
`playground headers list`	List playground headers for an environment	View docs
`playground headers remove`	Remove a playground header	View docs
`telemetry enable`	Opt this machine into anonymous CLI usage reporting	View docs
`telemetry disable`	Opt this machine out of anonymous CLI usage reporting	View docs
`telemetry status`	Show the current telemetry setting and anonymous machine ID	View docs
`tunnel`	Expose a local server to the internet through an Alpic tunnel	View docs

Getting started

Authentication

Deployment

Devtools

Logs

User insights

Distribution

Git

Playground

Teams

Projects

Environments

Environment variables

Telemetry

Alpic CLI

Installing Alpic CLI

Authentication

API key

Checking the version

Available Commands

​Installing Alpic CLI

​Authentication

​Browser login (recommended)

​API key

​Checking the version

​Available Commands

Installing Alpic CLI

Authentication

Browser login (recommended)

API key

Checking the version

Available Commands