Skip to main content
The Suxiaoqiang CLI synchronizes a superun project’s files with a local directory. Its terminal command is sxq. You can edit the project in your preferred IDE or with an AI coding agent, push changes back, build a preview, and deploy to production.
The CLI shares its name with superun’s in-product AI assistant, Suxiaoqiang, but they are different things. The assistant provides guidance in superun; the sxq command manages a project from your terminal.
It is a project development and release tool. It does not replace the superun CLI, which operates a running app’s business data and APIs.

​
Before you start

You need:
  • Node.js 18 or later;
  • access to the superun project you want to link;
  • the project’s sessionId, shown in its superun project URL.

​
Install and log in

sxq login opens a browser to authorize the CLI. You can also use an existing token:
Create an empty directory, link it to the remote project, and pull its files:
Linking verifies that the project belongs to the signed-in account. The first pull is full; later pulls are incremental and use a three-way merge.

​
Edit and push changes

After editing locally, push the changes back to superun:
sxq push pulls remote changes first. If a file cannot be merged cleanly, the command stops and writes Git-style <<<<<<<, =======, and >>>>>>> conflict markers into the file. Resolve every conflict, remove the markers, test the result, and run sxq push again. Files matched by the project’s .gitignore, plus built-in entries such as node_modules, dist, and .git, are not synchronized.

​
Preview and deploy

Trigger a debug build and wait for its preview URL:
When the preview is ready and verified, deploy the pending version:
Check release state without deploying:
sxq deploy changes the live application and may incur cloud service fees. Verify the linked project, preview, and target region before confirming.

​
Apply database migrations

Create migration files under supabase/migrations/ using this format:
A timestamp prefix is recommended, for example:
Then apply migrations that do not yet exist remotely:
Migrations run in filename order and stop at the first failure. After a migration succeeds, the server saves it as a project attachment. Do not send migration files with sxq push; the CLI blocks them.

​
Command reference

For CI or an AI agent, use -y on commands that would otherwise ask for confirmation. In a non-interactive environment, the CLI fails with guidance instead of waiting indefinitely.

Suxiaoqiang CLI on npm

View the published package and current version.

Source code

Read the complete reference or report an issue.