Vertal← Back
Version 1.0

VERTAL CLI

Develop, deploy, manage and scale applications straight from your terminal with the VERTAL Command Line Interface.

OverviewFeaturesInstallationAuthenticationCreate a ProjectStatus & LogsDeploy ApplicationsREST API (AI Agents)Edge RuntimeDatabaseAI ServicesEnvironment VariablesDomainsLogsAnalyticsTeam ManagementConfigurationSecurityCI/CD IntegrationBest PracticesSupport

Overview

The VERTAL CLI is the official command line tool for the VERTAL platform. Built for developers, DevOps engineers and enterprise teams, it simplifies development and infrastructure management, integrating natively with CI/CD pipelines and automation workflows.

Features

  • Project Management
  • Application Deployment
  • Edge Runtime Deployment
  • Serverless Functions
  • Database Management
  • AI Service Integration
  • Environment Variables
  • Secrets Management
  • Domain Management
  • Real-Time Logs
  • Analytics
  • Build Automation
  • Team Collaboration
  • CI/CD Integration

Installation

Install the latest version with your preferred package manager.

npm
npm install -g vertal
pnpm
pnpm add -g vertal
Yarn
yarn global add vertal

Verify the installation:

vertal help

Authentication

Generate a key under Settings → API Keys and authenticate the CLI. The key is stored in ~/.vertal/config.json with permission 600 and is never printed in the terminal.

vertal login
vertal login --token vt_xxx --api https://vertal.app
vertal whoami
vertal logout

Create a Project

vertal init
vertal init --name my-app --repo owner/repo --branch main
vertal init --project <project-id>   # link an existing project
vertal projects

Status & Logs

vertal status
vertal logs -f
vertal context

Deploy Applications

vertal deploy               # trigger and follow until finished
vertal deploy --no-wait
vertal deploy --project <project-id>

REST API (AI Agents)

Every CLI command maps to a REST endpoint, so any AI agent (Cursor, Trae, Windsurf, Claude) can drive Vertal over HTTP with the same vt_....

GET  /api/public/v1/whoami
GET  /api/public/v1/projects
POST /api/public/v1/projects           {"name","githubRepo","branch"}
GET  /api/public/v1/projects/:id
POST /api/public/v1/deployments        {"projectId"}
GET  /api/public/v1/deployments/:id
GET  /api/public/v1/logs?projectId=…
curl -X POST https://vertal.app/api/public/v1/deployments \
  -H "Authorization: Bearer $VERTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"<uuid>"}'

Responses use the envelope { success, data, error }.

Edge Runtime

vertal edge deploy
vertal edge list
vertal edge remove

Database

vertal db create
vertal db list
vertal db connect
vertal db migrate
vertal db backup
vertal db restore

AI Services

vertal ai generate
vertal ai chat
vertal ai models

Environment Variables

vertal env list
vertal env add
vertal env remove

Domains

vertal domains list
vertal domains add
vertal domains remove

Logs

vertal logs
vertal logs --follow

Analytics

vertal analytics
vertal analytics report

Team Management

vertal team invite
vertal team list
vertal team roles

Configuration

vertal config
vertal config set

Security

  • Secure authentication
  • API token management
  • Role-based access control (RBAC)
  • Encrypted communication
  • Secrets management
  • Audit logs

Cybersecurity operations supported by Cyber Segurit Infinit.

CI/CD Integration

  • GitHub Actions
  • GitLab CI/CD
  • Jenkins
  • Azure DevOps
  • CircleCI
  • Bitbucket Pipelines

Best Practices

  • Keep the CLI up to date.
  • Store API tokens securely.
  • Use environment variables for secrets.
  • Review deploy logs after every release.
  • Test in preview environments before promoting to production.

Support

Website: https://vertal.app
Documentation: /whitepaper
Support: support@vertal.app