Skip to content
nsin docs

Commands

The NSIN CLOUD command bar turns one typed line into one app or database action. There is no AI behind it: a small set of patterns matches what you type, and each one maps to exactly one REST call — the same call the MCP tools make.

  • ⌘K or Ctrl K opens the bar anywhere in the panel.
  • Tab completes the command you started typing.
  • ? opens this page in a new tab.

In the syntax below, <angle brackets> mark a required argument and [square brackets] an optional one. Tab fills in the required arguments and stops there — an optional argument only ever shows what you typed yourself.

Every command that starts with a name takes it first or last — shop logs and logs shop both work. The table below shows the name-first form.

In the table, <app> is an app’s name. Where a row says so, a database’s name works too. <db> is a database’s name only.

As you type a name, the bar offers only the commands that name has. scale, restart and redeploy are for apps only. Typed with a database’s name, they show an error and send nothing.

The first pattern that matches a line wins.

Deleting an app or a database is not a command. Destructive actions live on the resource’s own Settings page, behind a confirmation dialog.

CommandExampleWhat it doesAPI call
deploy <image|git-url> as <name> [port N]deploy nginx:alpine as demo port 80Creates the app from a container image or a git repository and starts its first build. The port defaults to 80 for nginx images and 3000 otherwise.POST /v1/{project}/apps
<app> logsshop logsOpens the live log of an app — or of a database, when the name is one.nothing sent — opens a page
<app> metricsshop metricsOpens CPU, memory, network and restart charts for an app — or a database, when the name is one.nothing sent — opens a page
<app> terminalshop terminalOpens a shell inside a running pod of the app or database. “shell” works too.nothing sent — opens a page
<app> diskshop diskOpens the disks of an app or a database. “disks” works too.nothing sent — opens a page
<app> settingsshop settingsOpens the settings of an app or a database.nothing sent — opens a page
<app> billingshop billingOpens what an app or a database has cost so far. “cost” works too.nothing sent — opens a page
<db> backupspg backupsOpens the backups of a database. “backup” works too.nothing sent — opens a page
<db> eventspg eventsOpens the event history of a database.nothing sent — opens a page
<app> scale <replicas>shop scale 2Sets how many replicas of the app run.POST /v1/{project}/apps/:app/scale
<app> restartshop restartRolls the app’s pods, keeping the image that is deployed.POST /v1/{project}/apps/:app/restart
<app> redeployshop redeployBuilds and deploys the app again from its current source. “deploy” alone works too.POST /v1/{project}/apps/:app/deploy
<app> openshop openOpens the overview of an app or a database. “go” does the same, and the name alone searches.nothing sent — opens a page
db <name> <engine> [version]db pg postgres 16Creates a managed database. Without a version you get the default one for that engine.POST /v1/{project}/databases
link <db> to <app>link pg to shopInjects the database’s connection variables into the app’s environment.POST /v1/{project}/databases/:db/link
helphelpOpens this page in a new tab. ”?” works too.nothing sent — opens a page

<engine> is one of: postgres, pgvector, mysql, mariadb, redis, mongodb, clickhouse, elasticsearch, meilisearch.

Anything you type that isn’t one of the commands above is a search. The bar matches it against the names of your apps and databases (and their status and source), lists what it finds under Recent, and Enter opens the highlighted one. It’s a local filter over the lists the panel already has — no request is made while you type.

Arrow keys move through the list, Enter opens, Escape closes.

Every command here also has an MCP tool and a REST endpoint behind it — the same call, whichever way you trigger it. NSIN CLOUD runs its own MCP server at https://api.nsincloud.ir/mcp, the same way nsin’s MCP server does, and its REST API follows the same conventions: an API key as Authorization: Bearer or X-Api-Key.