upuai-cli

$ upuai version
upuai/0.0.2 (206c727) built 2026-04-23T18:37:12Z

$ upuai login

▸ Opening browser for authentication...
✓ Logged in as gabriel@upuai.com.br
  Organization: Upuai Labs
  Default project: my-app

$ upuai whoami

User: gabriel@upuai.com.br
Organization: Upuai Labs
Default project: my-app

$ upuai init

? Project name: my-app
? Detected: Node.js (Next.js)
? Build command: pnpm run build
? Start command: pnpm start

✓ Project ready to deploy

$ upuai link

? Select a project:
  ❯ my-app (production)
    api-service (staging)
    landing-page (production)

✓ Linked to my-app

$ upuai list

NAME             ID                STATUS     CREATED
my-app           prj_abc123        Active     2d ago
api-service      prj_def456        Active     1w ago
landing-page     prj_ghi789        Active     2w ago

$ upuai status

Project: my-app (production)
URL: https://my-app.upuai.com.br

Services:
  web     ● Running  2/2 instances  CPU: 23%  MEM: 412Mi
  worker  ● Running  1/1 instances  CPU: 8%   MEM: 256Mi

Last deploy: 2h ago (v1.4.2) by gabriel@upuai.com.br

$ upuai deploy

▸ Uploading my-app (3.2 MB)
▸ Building with upuaipack...
▸ Build completed in 42s
▸ Deploying (rolling)...
▸ Health check passed

✓ Deployed to https://my-app.upuai.com.br
  Deploy ID: dep_abc123
  Duration: 1m 12s

$ upuai deploy --watch

◉ Watching for changes...
▸ src/index.ts changed — redeploying...
✓ Deployed in 38s
◉ Watching for changes...

$ upuai rollback

✓ Rolled back to previous deployment (dep_xyz789)

$ upuai promote

▸ Promoting staging → production
▸ Deployment dep_stg_001 → dep_prd_002
✓ Production updated. URL: https://my-app.upuai.com.br

$ upuai down

▸ Removing deployment for web...
✓ Service stopped. No instances running.

$ upuai add

? Service type:
  ❯ app
    bucket
    database
    docker
    docker image
    function
    github
    gitlab

? Service name: api
✓ Service api added to project

$ upuai logs -n 50

[web] 2026-02-14T10:23:01Z  GET /api/users 200 12ms
[web] 2026-02-14T10:23:02Z  GET /api/health 200 2ms
[web] 2026-02-14T10:23:05Z  POST /api/orders 201 45ms
[web] 2026-02-14T10:23:08Z  GET /api/users/42 200 8ms

$ upuai ps

NAME     TYPE     REPLICAS   COMMAND
web      web      2          bundle exec puma
worker   worker   1          bundle exec sidekiq
clock    clock    1          bundle exec clockwork clock.rb

$ upuai scale 5
▸ Scaling web: 2 → 5 instances
✓ web scaled to 5 instances

$ upuai scale web=2 worker=3
▸ Scaling web: 5 → 2 · worker: 1 → 3
✓ scaled

$ upuai restart

▸ Restarting web...
✓ Service restarted

$ upuai run npx prisma migrate deploy

▸ Injecting 5 environment variable(s)
▸ Running: npx prisma migrate deploy

Applying migration: 20260214_add_orders
✓ Migration complete

$ upuai run -s api -- env | grep DATABASE_URL
DATABASE_URL=postgres://user:****@xq7zk3pm.db.upuai.cloud:5432/app

$ upuai shell -s api

ℹ Spawning /bin/zsh with 7 variable(s) from service
ℹ Type 'exit' to leave the subshell

api %  printenv DATABASE_URL
postgres://user:****@xq7zk3pm.db.upuai.cloud:5432/app
api %  exit

$ upuai db connect

▸ Fetching access status...
✓ public access enabled at xq7zk3pm.db.upuai.cloud:5432
ℹ opening psql → xq7zk3pm.db.upuai.cloud:5432

psql (16.4)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384)
Type "help" for help.

app=> \dt
            List of relations
 Schema |   Name    | Type  |  Owner
--------+-----------+-------+----------
 public | users     | table | postgres
 public | orders    | table | postgres
(2 rows)

app=> \q

$ upuai db connect --print

Host: xq7zk3pm.db.upuai.cloud  Port: 5432

postgres://app_user:****@xq7zk3pm.db.upuai.cloud:5432/app?sslmode=require

$ upuai db backup --out backup-2026-04-28.dump

ℹ running pg_dump → backup-2026-04-28.dump
✓ backup written: backup-2026-04-28.dump (12834567 bytes)

$ upuai db restore -f backup-2026-04-28.dump

? Restore backup-2026-04-28.dump into the linked database? This rewrites matching objects. Yes
ℹ running pg_restore from backup-2026-04-28.dump
✓ restore complete

$ upuai env

? Select environment:
  ❯ production (active)
    staging
    development

✓ Active environment: production

$ upuai env list

NAME           ID              ACTIVE   EPHEMERAL
production     env_abc123      ●        No
staging        env_def456                No
development    env_ghi789                No

$ upuai env switch staging
✓ Active environment: staging

$ upuai env new preview
✓ Environment preview created

$ upuai vars set DATABASE_URL=postgres://user:pass@host/db NODE_ENV=production
✓ 2 variables set

$ upuai vars list

NAME              VALUE                    SECRET
DATABASE_URL      postgres://user:***      Yes
REDIS_URL         redis://localhost:6379   No
API_KEY           ****                     Yes
NODE_ENV          production               No

$ upuai domain add example.com

▸ Configure these DNS records:

  Type    Name               Value
  A       example.com        <IP shown by the CLI>
  CNAME   www.example.com    <target shown by the CLI>

✓ Domain added (pair: example.com + www.example.com).
  www.example.com → example.com (301). Configure DNS and it will be verified automatically.

$ upuai domains list

DOMAIN                    TYPE     STATUS        REDIRECT                  ID
my-app.upuai.com.br       Auto     ● Active      -                         dom_abc123
example.com               Custom   ● Active      -                         dom_def456
www.example.com           Custom   ● Active      → example.com (301)       dom_def457
api.example.com           Custom   ○ Pending     -                         dom_ghi789

# Add already redirecting to the canonical host
$ upuai domain add www.example.com --redirect-to example.com --status 301

# Turn the redirect on/off (or switch direction) on an existing domain
$ upuai domain update www.example.com --redirect-to example.com
$ upuai domain update www.example.com --no-redirect
✓ Redirect updated — live within 2 minutes, no redeploy

$ upuai version
upuai-cli/1.2.0 (abc1234) built 2026-02-14

$ upuai completion zsh > ~/.zsh/completions/_upuai
✓ Completion script generated

$ upuai upgrade
▸ Checking for updates...
✓ Upgraded from 1.1.0 → 1.2.0

$ upuai deploy --project my-app --environment staging --output json --yes

{
  "status": "success",
  "deployId": "dep_abc123",
  "url": "https://my-app-staging.upuai.com.br"
}