@gizai/cli 1.2.1 → 1.3.0

package/README.md

@@ -5,7 +5,7 @@ Connect once in the browser, then use live Giz text and media models, Drive, and
 ```bash
 npm install -g @gizai/cli
 giz auth login
-giz chat gpt-5-6-luna "Say hello in Korean"
+giz chat gpt-6-luna "Say hello in Korean"
 giz generate image "A paper observatory at blue hour"
 ```
 
@@ -130,6 +130,7 @@ App 변경은 `giz app list`에서 확인한 `revision`을 명시적으로 전
 | job get | job.get | job_get | job | giz.read | server job |
 | job wait | job.get | job_get | job | giz.read | server job |
 | job cancel | job.cancel | job_cancel | job | giz.destructive | server job |
+| credits | account.credits | account_credits | - | giz.read | account.credits |
 | drive ls | drive.list | drive_list | - | giz.read | drive.list |
 | drive list | drive.list | drive_list | - | giz.read | drive.list |
 | drive search | drive.search | drive_search | query | giz.read | drive.search |

package/cli/giz.mjs

@@ -450,7 +450,13 @@ async function runCommand(baseUrl, positionals, options) {
     const revision = await managedRevision()
     return { kind: 'message', value: CLI_VERSION + (revision ? ` (region ${revision.trim()})` : '') }
   }
-  if (!command || command === 'help' || options.help === true) return { kind: 'help', value: help(command) }
+  if (!command || command === 'help' || options.help === true) {
+    // A script that asks for help on a command that does not exist must fail, not read the overview as success.
+    if (command && command !== 'help' && !help().split('\n').some((line) => line.trim().split(' ')[1] === command && line.startsWith('  giz '))) {
+      throw new CliError(`Unknown command "${command}".`, 'Run: giz --help')
+    }
+    return { kind: 'help', value: help(command) }
+  }
   if (command === 'engine' && subcommand === 'run') {
     if (rest[0] !== 'claude') throw new CliError('Only Claude Code is an engine connection.')
     await api(baseUrl, '/api/external/engine/claude/authorization')
@@ -505,6 +511,11 @@ async function runCommand(baseUrl, positionals, options) {
     }
   }
 
+  if (command === 'credits') {
+    // Batch scripts read the balance before paid work instead of learning it from a refusal (MCP-TOOL-SCHEMA-LIMITS).
+    if (subcommand) throw new CliError(`Unknown command "credits ${subcommand}".`, 'Run: giz credits')
+    return { kind: 'result', value: await invoke(baseUrl, 'account.credits', {}) }
+  }
   if (command === 'model' && subcommand === 'list') {
     return {
       kind: 'models',
@@ -897,6 +908,11 @@ Progress and the final diff, files and summary are returned. Interrupting stops
   giz api-key revoke KEY_ID
 
 The secret is shown only when the key is created.`
+  if (command === 'credits') return `Usage
+  giz credits
+
+Prints your remaining credit (purchased and plan), when plan credit resets, and this month's spend and charges.
+In a workspace it prints the workspace's monthly budget. Read it before paid batch work.`
   if (command === 'chat') return `Usage
   giz chat MODEL "your prompt"
   giz chat MODEL --input '{"messages":[{"role":"user","content":"Hello"}]}'`
@@ -987,6 +1003,7 @@ Usage
   giz generate image|video|music|talking-head "PROMPT" [--model MODEL]
   giz generate audio --input JSON [--model MODEL]
   giz job list|get|wait|cancel [JOB]
+  giz credits
   giz drive ls|list|search|read|write|mkdir|move|delete
   giz table list|get|read|write|action
   giz upload LOCAL_PATH

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gizai/cli",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Giz CLI, MCP installer, OpenAI-compatible models, Drive, and Computer",
   "type": "module",
   "bin": {

package/skills/giz/SKILL.md

@@ -36,7 +36,7 @@ giz model run MODEL_ID --input '{"prompt":"..."}'
 Use the OpenAI-compatible chat boundary:
 
 ```bash
-giz chat gpt-5-6-luna "..."
+giz chat gpt-6-luna "..."
 ```
 
 Upload local media into an exact model field:
@@ -88,6 +88,7 @@ App 변경은 `giz app list`에서 확인한 `revision`을 명시적으로 전
 | job get | job.get | job_get | job | giz.read | server job |
 | job wait | job.get | job_get | job | giz.read | server job |
 | job cancel | job.cancel | job_cancel | job | giz.destructive | server job |
+| credits | account.credits | account_credits | - | giz.read | account.credits |
 | drive ls | drive.list | drive_list | - | giz.read | drive.list |
 | drive list | drive.list | drive_list | - | giz.read | drive.list |
 | drive search | drive.search | drive_search | query | giz.read | drive.search |