CLI commands

Complete reference for all Apso CLI commands.

Project commands

Command	Description
`apso init`	Create a new project or clone an existing one
`apso generate`	Generate code from `.apsorc` schema
`apso dev`	Detect the project language and start its local server
`apso doctor`	Diagnose generated code, dependencies, Git, and project configuration

Command	Description
`apso migrate`	Test schema migrations locally with PGlite
`apso schema validate`	Validate local `.apsorc` schema
`apso schema diff`	Show diff between local and remote schema
`apso schema push`	Push local schema to platform
`apso schema pull`	Pull remote schema to local `.apsorc`

Command	Description
`apso deploy`	Deploy to Apso platform
`apso status`	Show service and build status
`apso logs`	View build logs
`apso open`	Open service dashboard in browser
`apso github connect`	Authorize GitHub for repository synchronization

Command	Description
`apso login`	Authenticate with Apso platform
`apso logout`	Clear stored credentials
`apso whoami`	Show current authenticated user

Command	Description
`apso link`	Link project to a platform service
`apso unlink`	Remove platform link
`apso projects`	List services in a workspace
`apso use <workspace>`	Select the active workspace
`apso config`	View or modify CLI configuration

Command	Description
`apso import supabase`	Read a Supabase PostgreSQL schema and create a local `.apsorc` file
`apso import data`	Copy table data from the source database into the target database rebuilt from that schema

The schema import is read-only against the source database. Review the generated .apsorc before creating the target service or copying data.

Command	Description
`apso mcp serve`	Start the stdio MCP server for a compatible coding agent

Command	Description
`apso update`	Update the CLI to the latest available version

These options work with any command:


apso [command] --help       # Show command help
apso [command] --version    # Show CLI version

The following commands still work but redirect to their replacements:

Old command	Replacement
`apso server new`	`apso init`
`apso server scaffold`	`apso generate`

Create a new project

Generate code from schema

Test migrations locally

Deploy to Apso platform

CLI configuration

Authentication