SDKs & Tools

CLI

Sign in, manage organizations, projects, and workload identities, and run workers from the terminal.

Use the spiral CLI to sign in and manage your application's resources from the terminal.

Install

Install from PyPI:

pip install 'spiral-cli[sql]'
spiral login

The spiral-cli installation supplies sign-in, identity, Organization, Project, storage, Workload, Connection and documentation commands. SQL and local Connect require the separately installed spiral-sql package. spiral sql dispatches to spiral-sql, and spiral connect dispatches to spiral-connect. Install spiral-cli[sql] for both. Worker execution requires the spiral-host execution host; its reference page states this requirement. Configure table compaction in Studio.

Commands

CommandSummary
spiral loginAuthenticate with SpiralDB
spiral logoutRemove stored SpiralDB credentials from this machine
spiral whoamiShow information about the currently authenticated principal
spiral workerExecute durable Spiral Tasks
spiral docsPrint LLM-friendly documentation as Markdown
spiral orgsManage organizations, members, and settings
spiral projectsCreate projects and manage access grants
spiral fsConfigure Project storage and mounts
spiral volumesRegister Volumes and manage storage credentials
spiral workloadsManage workload identities and how they sign in
spiral connectionsManage Connections: named credentials for external systems
spiral sqlRun DataFusion SQL and SPQL functions
spiral connectServe ScanDAL on this machine for Spiral Studio on the web
Found a problem? Edit this page or report an issue.

On this page