---
name: appmana-cli
description: Use this skill when creating an AppMana account, authenticating, provisioning Git LFS, or building, deploying, and publishing Streamed (Windows/Linux GPU) or WebGL Unity projects with the appmana CLI (@appmana-public/cli).
---

# AppMana CLI (`@appmana-public/cli`) Skill

## Overview
`@appmana-public/cli` (`appmana`) manages AppMana accounts, workspaces, Git LFS repositories, cloud Unity builds, GPU streaming deployments, and WebGL publications through `https://appmana.com/graphql`.

- **Config**: `~/.config/appmana/config.yaml` (`endpoint`, `issuer`, `clientId`, `cluster`, `namespace`, `output`)
- **Credentials**: `~/.config/appmana/credentials.json` (mode `0600`, auto-refreshes OAuth 2.0 device tokens)
- **Environment Overrides**: `APPMANA_CREDENTIALS_FILE`, `APPMANA_TOKEN`, `APPMANA_CLUSTER` (default `appmana-cluster-03`), `APPMANA_NAMESPACE` (default `user-<sub>`), `APPMANA_OUTPUT` (`json|yaml|table`)
- **Exit Codes**: `0` ok, `1` GraphQL/runtime error, `2` usage/`BAD_USER_INPUT`, `3` `UNAUTHENTICATED`, `4` `FORBIDDEN`, `6` network unavailable

## 1. Account Creation & Authentication

### Browserless Account Creation (for AI Agents & Automation)
```bash
umask 077 && printf '%s\n' "$PASSWORD" > ~/.config/appmana/account.password
appmana account create \
  --email dev@example.com \
  --first-name Dev \
  --last-name User \
  --password-file ~/.config/appmana/account.password \
  --accept-terms \
  --verification-link-file /tmp/appmana-verify.url
```

### Interactive Device Login & Status Check
```bash
appmana login
appmana whoami --remote
appmana accounts status
appmana accounts request-access
```

## 2. Installing the Plugin & Provisioning Git LFS
From the Unity project directory:
```bash
# Add OpenUPM scoped registry and com.appmana.unity.public to Packages/manifest.json
appmana unity install . --public-only

# Provision an LfsRepository on lfs.appmana.com and merge .lfsconfig into your branch
appmana lfs provision
git push
```

## 3. Creating & Building a Streamed Unity Project (Windows / Linux GPU)

Create `source.yaml`, `project.yaml`, and `deployment.yaml`:
```yaml
# source.yaml
apiVersion: build.appmana.com/v1alpha1
kind: SourceCredentialBinding
metadata:
  name: my-game-source
  namespace: user-<sub>
spec:
  provider: github
  accountRef: <github-username>
  repositoryScope: https://github.com/<owner>/<repo>
---
# project.yaml
apiVersion: build.appmana.com/v1alpha1
kind: BuildProject
metadata:
  name: my-game
  namespace: user-<sub>
spec:
  displayName: My Game
  lfs:
    enabled: true
    unlimited: true
  source:
    provider: git
    git:
      repository: https://github.com/<owner>/<repo>
    revision: main
    credentialBindingRef:
      name: my-game-source
  targets:
    windows: true
    linux: true
    webgl: false
  unity:
    version: automatic
    projectPath: .
  runtimeDefaults:
    maxBitrate: 14000000
    maxEncodingDimension: 2048
---
# deployment.yaml
apiVersion: build.appmana.com/v1alpha1
kind: StreamingDeployment
metadata:
  name: my-game
  namespace: user-<sub>
spec:
  projectRef:
    name: my-game
  clusterTargetRef:
    name: appmana-cluster-03
  platforms:
    windows: true
    linux: true
  graphics:
    windows: direct3d12
    linux: vulkan
  resources:
    requested:
      cpu: "2000m"
      memory: "4000Mi"
      gpuCount: 1
      gpuMemoryMiB: 2048
  scaling:
    minReplicas: 1
    maxReplicas: 8
    idleSeconds: 300
  settings:
    targetFrameRate: 60
    maxBitrate: 14000000
    maxEncodingDimension: 2048
    useHardwareEncoder: true
    quitInsteadOfIdle: true
```

Run the lifecycle commands:
```bash
# Create resources
appmana projects create \
  --build-project @project.yaml \
  --streaming-deployment @deployment.yaml \
  --source-credential-binding @source.yaml

# Trigger build
appmana projects build my-game --revision main --windows --linux --no-webgl

# Monitor build & query logs
appmana build-requests list --project my-game
appmana logs query --query '{namespace="user-<sub>-build"}' --start 2026-11-17T00:00:00Z --end 2026-11-17T23:59:59Z

# Deploy immutable BuildArtifact to StreamingDeployment
appmana build-artifacts list --project my-game -o json
appmana projects deploy my-game --artifact <artifact-name> --deployment my-game --dry-run
appmana projects deploy my-game --artifact <artifact-name> --deployment my-game

# Verify rollout readiness
appmana streaming-deployments get my-game -o json

# Publish public watch alias (https://appmana.com/watch/<alias>)
appmana projects publish my-game --deployment my-game --alias my-game-live --dry-run
appmana projects publish my-game --deployment my-game --alias my-game-live
```

## 4. Building & Publishing a WebGL Project
```bash
# Enable WebGL target and submit build
appmana projects patch my-game --input '{"spec":{"targets":{"webgl":true}}}'
appmana projects build my-game --revision main --webgl --no-windows --no-linux

# Promote OCI file artifact to public CDN delivery
appmana build-artifacts list --project my-game -o json
appmana projects publish-files my-game --artifact <artifact-name> --publication my-game-webgl-v1 --dry-run
appmana projects publish-files my-game --artifact <artifact-name> --publication my-game-webgl-v1

# Wait for status.phase == "Published", then select active WebGL publication
appmana artifact-publications get my-game-webgl-v1 -o json
appmana projects select-webgl my-game --publication my-game-webgl-v1 --dry-run
appmana projects select-webgl my-game --publication my-game-webgl-v1
```

## 5. Streaming from a Local Unity Editor or Player
```bash
appmana signaling-host-credentials provision my-game
# Launches with: APPMANA_SIGNALING_CREDENTIAL_FILE=<file> <player> AppSettings:artifactId=dev-my-game-<hash> AppSettings:targetUrl=https://signaling-h2.appmana.com:443
appmana signaling-host-credentials revoke my-game-<machine>
```
