> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Command-line tools

> Choose between the superun CLI for operating a running app and the Suxiaoqiang CLI for developing and publishing an app.

superun provides two official command-line tools. They work at different layers of an app and are not interchangeable.

|                         | **superun CLI**                                             | **Suxiaoqiang CLI**                                         |
| ----------------------- | ----------------------------------------------------------- | ----------------------------------------------------------- |
| Terminal command        | `superun`                                                   | `sxq`                                                       |
| npm package             | `superun-cli`                                               | `suxiaoqiang-cli`                                           |
| Works with              | A running app's data and APIs                               | An app project's source files and releases                  |
| Typical tasks           | Query or update business data, call RPCs and Edge Functions | Pull and push code, build a preview, deploy, run migrations |
| Best for                | Operations, automation, and AI agents using the app         | Local development, AI coding agents, and CI                 |
| Minimum Node.js version | 20                                                          | 18                                                          |

<Note>
  The easiest way to remember the difference: **`superun` uses the app; `sxq` builds the app.**
</Note>

## Choose the right CLI

Use the **superun CLI** when you want to:

* inspect tables or read and update rows as the signed-in user;
* call a Postgres RPC or an app Edge Function;
* let a trusted AI agent perform business actions in your app;
* switch between multiple configured app backends without checking out their source code.

Use the **Suxiaoqiang CLI** when you want to:

* download a superun project's files to a local directory;
* edit the project in your IDE or with an AI coding agent and sync the changes back;
* trigger a preview build or deploy a release;
* apply new SQL migration files from `supabase/migrations/`.

## Similar-looking tasks that are different

| Task                                        | Use                                    | Why                                                  |
| ------------------------------------------- | -------------------------------------- | ---------------------------------------------------- |
| Change one customer's order status          | `superun db update` or an app function | This changes business data in a running app          |
| Add an `orders.status` column               | `sxq db push`                          | This changes the database schema through a migration |
| Call `send-invoice` for an order            | `superun fn ...`                       | This invokes an app capability                       |
| Change the implementation of `send-invoice` | `sxq pull` / `sxq push`                | This changes project source code                     |
| Put a completed version online              | `sxq deploy`                           | This publishes the project                           |

<Warning>
  `superun db` writes affect application data immediately, while `sxq deploy` and `sxq db push` can change the deployed app or its schema. Review the target app and command before confirming any write, migration, or deployment.
</Warning>

<CardGroup cols={2}>
  <Card title="Use the superun CLI" icon="terminal" href="/superun/cli/superun-cli">
    Operate app data and APIs as the current user.
  </Card>

  <Card title="Use the Suxiaoqiang CLI" icon="code" href="/superun/cli/suxiaoqiang-cli">
    Develop, sync, preview, and deploy a superun project.
  </Card>
</CardGroup>