Major CLI

The official command-line interface for Major — the platform for deploying and managing secure internal tools.

Major empowers engineering teams to:

• Deploy instantly: Ship code to hosted infrastructure with a single command.
• Secure access: Manage RBAC and permissions for all your internal apps.
• Connect resources: Securely route traffic to internal databases and APIs.

For comprehensive guides, command references, and API documentation, visit our Official Documentation.

Installation

Direct Install

curl -fsSL https://install.major.build | bash

Homebrew

brew tap major-technology/tap
brew install major-technology/tap/major

Updating

Update to the latest version automatically, regardless of install method:

major update

Quick Start

1. Authenticate Log in to your Major account. This stores your credentials securely in your system keychain.

major user login

The CLI resolves credentials in this order:

1. MAJOR_TOKEN, if set to a non-empty value
2. The system keychain entry created by major user login

MAJOR_API_URL overrides the embedded API base URL and should include the /cli path (for example http://localhost:3001/cli). A trailing slash is ignored. Other embedded defaults are unchanged when this variable is unset.

When MAJOR_TOKEN is set, major user login, major user logout, and major user token refuse to run because the credential is externally managed. Ordinary commands continue to send Authorization: Bearer <token> using the injected value.

--non-interactive never prompts or opens a browser and does not imply --yes. Git remotes set GIT_TERMINAL_PROMPT=0 and insert OpenSSH BatchMode=yes after a single direct ssh executable (including a path whose basename is ssh). Quoted and escaped arguments are preserved. GIT_SSH_COMMAND wrappers (env ... ssh), other first executables, and compound commands (ssh ...; ...) are rejected; use a direct ssh command or run without --non-interactive.

2. Create a new App Scaffolds a new Major application in your current directory. You'll be prompted to choose a template.

major app create

3. Start Development Installs dependencies (pnpm install) and starts the local development server (pnpm dev).

major app start

Documentation

For detailed usage instructions, configuration options, and full command references, please visit the Major Documentation.

License

MIT