CLI command reference

wings

Usage:
  wings version                 Show version and build information
  wings login                   Log in via AGI Lab OAuth
  wings logout                  Revoke server session and remove stored credentials
  wings update [--check]        Update this CLI and installed skills from the latest release
  wings usage [--days 30]       Show compute quota and usage
  wings run [flags] [handler-id]
                                     Run JavaScript code or a saved handler
  wings run show <handler-id> <run-id>
                                     Show a run's status, error, HTTP status, and result
  wings save <run-id> --name "..."
                                     Save a run as a handler

  wings connection add <name> --preset slack|cloudflare|freee_oauth|google_oauth
                                     Add an OAuth preset connection
                                     For google_oauth, pass --client-credentials to use your own OAuth client
  wings connection add <name> --preset discord|google_sa|webull|x_oauth1
                                     Add a preset connection
                                     For webull, pass --app-key [--region us|hk|jp] and copy app secret
                                     For x_oauth1, copy JSON with api_key, api_key_secret, access_token, access_token_secret
  wings connection add <name> --host <hostname> --auth none|bearer|header:<name>
                                     Allow an exact host; none needs no credential or clipboard
                                     Other auth modes read the credential from clipboard
                                     Pass --replace to overwrite an existing non-hosted connection with the same name
  wings connection list                               List connections
  wings connection rename <old-name> <new-name>       Rename a connection
  wings connection remove <name> [--yes]              Disconnect

  wings db create <name>                         Create a database
  wings db list                                  List databases
  wings db query <name> "SQL" [--params '[...]'] Query a database
  wings db exec <name> "SQL" [--params '[...]']  Execute DDL/DML
  wings db delete <name> [--yes]                 Delete a database

  wings handler deploy [flags]                    Create or update a saved handler
  wings handler list                              List deployed handlers
  wings handler logs <id> [--limit N]             List recent runs with errors
  wings handler secret set <id> <name> [--stdin]  Set a handler secret from clipboard or stdin
  wings handler secret list <id>                  List handler secrets
  wings handler secret rm <id> <name> [--yes]     Remove a handler secret
  wings handler rm <id> [--yes]                   Remove a handler
  wings trigger add <handler-id> --schedule "..." [--args '{}' --tz Asia/Tokyo]
  wings trigger add-api <handler-id> --slug <api-slug> [--auth bearer|public] [--method GET|POST|PUT|PATCH|DELETE] [--allow-origin <origin>] [--no-open]
  wings trigger add-web <handler-id> --slug <app-slug>
  wings trigger list <handler-id>
  wings trigger show <handler-id> <trigger-id>
  wings trigger url <handler-id> <trigger-id>
  wings trigger share <handler-id> <trigger-id> --email <address> [--json]
  wings trigger unshare <handler-id> <trigger-id> --email <address> [--json]
  wings trigger shares <handler-id> <trigger-id> [--json]
  wings trigger enable <handler-id> <trigger-id>
  wings trigger disable <handler-id> <trigger-id>
  wings trigger rotate-secret <handler-id> <trigger-id> [--no-open]
  wings trigger rm <handler-id> <trigger-id> [--yes]

  wings skill install [--target all|claude-code|codex|gemini] [--force] [--yes]
  wings skill uninstall [--target all|claude-code|codex|gemini] [--yes]
  wings skill status

Handler Deploy Flags:
  --name "..."                       Handler name (required when creating)
  --update <handler-id>               Update a handler in place
  --code "..."                       Inline JavaScript source
  --file path                        Read JavaScript source from file
  --db <name>                        Bind a database as env.db
  --connection <code-name>=<name>    Bind a connection by stable ID (repeatable)
  --schedule "..."                   Optional schedule shortcut (creates trigger too)
  --args '{}'                        Optional trigger args (JSON, with --schedule)
  --tz "Asia/Tokyo"                  Trigger timezone (with --schedule; default: this computer's timezone)

Run flags:
  --code "..."                       Inline JavaScript source
  --file path                        Read JavaScript source from file
  --input path                       Stream a local file up to 1 GiB via env.input()
  --db <name>                        Bind a database as env.db for ad-hoc code
  --connection <code-name>=<name>    Bind a connection by stable ID (repeatable)
  --event '{}'                       Event object JSON

Schedule formats:
  every:5m | every:2h | every:1d@09:00
  weekly:mon,wed,fri@09:00
  monthly:1@09:00
  at:2026-05-01T09:00+09:00
  cron:0 9 * * 1-5

Documentation: https://agi-labo.com/tools/wings/docs
English: https://agi-labo.com/en/tools/wings/docs