Lunax CLI

Lunax CLI for reviewing and deploying a project

The CLI source includes sign-in, project linking and deployment commands. The public package has not been released. Examples explain the workflow; cloud execution depends on account access and service readiness.

Read the CLI guide Prefer AI? Meet LunaxCode

Follow a deployment

A floating glass terminal in a machined silver frame above an atmospheric cloud horizon. — Your terminal. A new horizon.

Public package not yet released
URL after successful deployment
Database management tools
Browser device login
Preview by default
Secret configuration workflow
Review a previous revision
CI token via LUNAX_TOKEN

Stay in your terminal.

Replay a deployment, inspect sample log output, or switch back to a previous revision. These examples simulate the CLI workflow.

Lunax / terminal

Interactive demo

Deploy

Subdomain

Database

Streaming logs

Rollback

Room to build. Clear limits.

AI token allowances belong to the agent. CLI hosting, storage and runtime usage are billed separately on the pricing page.

14-day launch trial

100M–1B gift tokens

Launch invitations include 100M, 250M, 500M or 1B tokens. Your invitation determines the allowance; seats open in limited waves.

Explore the launch trial

Predictable pacing

5-hour + 7-day windows

Paid plans spread their monthly allowance across five-hour and weekly windows. Your dashboard shows what remains and when each window resets.

Launch gift tokens use a separate vault; paid-plan pacing does not shrink your gift.

Continue with PAYG

220,000 Toman / 1M tokens

After a plan or pacing limit, continue only if you enable PAYG and fund your wallet. Hosting and storage remain separate.

Current enabled catalog rate. PAYG is opt-in and subject to account limits.

Start with your first idea.

No card or identity check to start building. Iranian wallet top-ups require identity verification.

Start building free

Quickstart

Command examples for the sign-in and deployment workflow; check public release and hosting readiness separately.

Sign in

Shows a short code and opens your browser — no token pasting (RFC 8628 device flow).

lunax login

Link and describe the project

Bind the folder to a site and write lunax.json with the detected platform.

lunax link
lunax init --platform next

Deploy a preview

Selects uploadable files according to project rules and submits them for a build. Review secret handling and output files before running it.

lunax deploy

Go live

Production deployment requires approval and service readiness. Before a rollback, check that the previous revision exists and that data remains compatible.

lunax deploy --prod
lunax rollback --prod

Everyday commands

Logs

Runtime logs of the latest deployment, or build logs for a build job. A failed deploy prints its build log automatically.

lunax logs --tail 200
lunax logs --build <id>

Environment variables

Use environment configuration for keys. Keep secret values out of logs, browser code and recorded commands.

lunax env ls
echo "$SECRET" | lunax env set API_KEY
lunax env rm API_KEY

Platform subdomains

Check availability, lock an instant vanity hostname under lunax.bond, or inspect its ingress state.

lunax subdomain check myapp
lunax subdomain set myapp
lunax subdomain get

Custom domains

Claim a hostname, point the DNS record we show you, then verify ownership.

lunax domains add app.example.com
lunax domains verify <domainId>

Status and sites

Preview and production state, revision id and errors for the linked site.

lunax status
lunax list

Database management

Provision CloudNativePG Postgres or MySQL, inspect schemas, and execute terminal queries.

lunax db info
lunax db create --engine postgres
lunax db inspect
lunax db query "select count(*) from users"

Installation and package manager

The installation example below depends on package publication and is not currently a working public install path. Read the CLI guide for current status.

bun add -g @lunax/cli
lunax deploy

Local dev

Runs your own package.json dev script on loopback. It does not emulate the cloud and needs no login.

lunax dev --port 5173

CI/CD

In CI, set LUNAX_TOKEN instead of logging in, and commit .lunax/link.json (it holds ids, not secrets).

GitHub Actions

.github/workflows/lunax.yml

on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: lunax deploy --prod
        env:
          LUNAX_TOKEN: ${{ secrets.LUNAX_TOKEN }}

GitLab CI

.gitlab-ci.yml — store LUNAX_TOKEN as a masked CI variable.

deploy:
  stage: deploy
  only: [main]
  script:
    - lunax deploy --prod

Review the CLI workflow in the guide.

Compare command examples and outputs with your project’s requirements. A successful local run alone does not establish cloud deployment readiness.

Read the CLI guide Prefer AI? Meet LunaxCode

on: push: branches: [main] jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: lunax deploy --prod env: LUNAX_TOKEN: ${{ secrets.LUNAX_TOKEN }}