ObjectStack CLI
DevOps for an AI-native business backend
The CLI is the universal control plane for ObjectStack. Scaffold projects, generate Zod-defined business objects, apply migrations, publish versioned artifact bundles, and manage MCP tool surfaces across environments. Everything Studio does is scriptable — built for CI/CD, GitOps, and platform teams.
Built for AI-Native Operations
Promote metadata, not snapshots. Audit every action, human or agent.
Metadata as Versioned Artifacts
Every ObjectStack project is a bundle of Zod objects, flows, views, and policies — declarative, diffable, signable. The CLI treats your business definition as the immutable artifact, the way you'd treat a container image.
CI/CD Pipeline Integration
Native support for GitHub Actions, GitLab CI, Jenkins, and Azure DevOps. Validate metadata, run policy tests, exercise MCP tool contracts, and promote artifact bundles as part of any pipeline.
Multi-Environment Promotion
Promote the exact same artifact bundle through dev, staging, and production. Differences live in environment metadata, not in code. Rollback is just promoting a previous bundle — auditable end to end.
Scriptable & Composable
JSON output mode, UNIX exit codes, composable subcommands. Build custom automation on stable CLI primitives — including agent-facing flows that drive ObjectStack via MCP.
Core Command Reference
Stable primitives for human, CI, and agent use.
# Scaffold a new ObjectStack project
$ object init [project-name]
# Business object management
$ object object [validate|generate|diff]
# Storage migration control
$ object migrate [up|down|status]
# Publish a versioned artifact bundle
$ object deploy [environment]
# Environment configuration management
$ object env [list|set|get]
# Driver management
$ object driver [install|list|test]Production Promotion Workflow
From local metadata to a production agent-ready backend.
Step 1: Validate Metadata
Run 'object object validate' in CI. Catch object, flow, and policy errors before promotion. Generate TS types and MCP tool signatures and commit them.
Step 2: Ephemeral Test Runtime
Spin up a throwaway runtime with 'object deploy test --ephemeral'. Run integration tests, MCP tool contract tests, and policy assertions against real kernel behavior.
Step 3: Promote the Artifact
Deploy to staging, smoke test, then promote the same signed artifact to production. Audit trail covers every promotion — humans and agents alike.
Enterprise Use Cases
Where CLI automation delivers strategic value.
Continuous Promotion Pipelines
Validate Zod objects, run policy tests, exercise MCP tool contracts, and promote artifact bundles on every commit. Same flow whether your backend is consumed by a UI, a service, or an AI agent.
Multi-Tenant Provisioning
Script tenant creation, clone metadata bundles per tenant with isolation, and manage thousands of tenants programmatically. The MCP surface tracks the same per-tenant boundaries.
Edge & IoT Runtimes
Package kernel + artifact bundle as a Docker image for edge devices, gateways, or POS hardware. Fleet-manage from a central CLI; rollouts are metadata promotions.
Backup, Export & Migration
'object export' captures the full project state — objects, flows, policies, data — for backup. 'object import' restores into a new runtime. Move between clouds, or cloud to on-premise, without lock-in.
Installation & Distribution
Available for all major platforms and package managers.
# Install globally via npm (Node.js required)
npm install -g @objectstack/cli
# Install via Homebrew package manager
brew install objectstack/tap/object-cli
# Run CLI in containerized environment
docker pull objectstack/cli:latest
# Download compiled binary (no runtime dependencies)
curl -fsSL https://cli.objectstack.ai/install.sh | shCLI as the Universal Control Plane
One interface across Studio, ObjectCloud, and self-hosted runtimes.
The same CLI drives local SQLite development, ObjectCloud's managed runtime, and self-hosted Kubernetes clusters. Promote the same versioned artifact bundle anywhere ObjectStack runs.
Standalone
Object Studio embeds the CLI for human workflows
Integrated
ObjectCloud exposes the identical CLI for operations
Define Your Business Once.
Let Humans And Agents Operate It Safely.
Stop scattering business logic across SQL, JavaScript, and UI state. Make objects, permissions, workflows, APIs, UI metadata, and agent tools one structured Zod source of truth — analyzable, versioned, and auditable end to end. Launch July 2026.