1.0.0 (2026-07-09)
First public release of the Altertable CLI — a command-line tool for the Altertable data platform: lakehouse data plane and management REST API.
Added
Lakehouse (data plane)
query— run SQL with human layout (--layout auto|table|line), serialized output (--format human|json|csv|markdown), column selection, max width, and pager controlsappend— insert rows (async or--sync)upload— bulk file ingest with streaming upload supportquery showandquery cancel— inspect and cancel running queriesappend status— poll append task statusschema— list schemas, tables, and columns in a lakehouse catalog
Management (control plane)
context— show active profile, environment, and authenticated identitycatalogs— list and create catalogsapi— HTTP invoker for the management REST API (api <METHOD> /path, bare paths default toGET, parameters inferPOST,-X/--methodoverrides the method,-f/--raw-fieldfor string parameters,-F/--fieldfor typed parameters)api routes— list operations from the bundled OpenAPI spec;api routes <operationId>shows one route with path parametersapi spec— print the bundled management OpenAPI specification (YAML or--json)
Configuration and authentication
- Dual-plane auth: management API key (Bearer) and lakehouse credentials (HTTP Basic)
configure— interactive wizard or flag-based credential setup, with optional verificationloginandlogout— browser-based OAuth authentication with profile-aware token storage- Automatic lakehouse credential provisioning for OAuth sessions
- Named profiles with
profile use,profile list,profile show, andprofile delete - Advanced profile workflows including
profile current,profile status,profile switch,profile env,profile direnv,profile create,profile update, andprofile rename - Environment variable overrides for credentials and endpoints
Developer experience
- Shell completion for bash, zsh, and fish (commands, subcommands, and leaf-command flags)
- Global
--jsonand--agentpresets for structured output and scripting - Stable exit codes and structured error envelopes
--debugwith verbose HTTP logging- Configurable connect and read timeouts (
--connect-timeout,--read-timeout, per-command--read-timeout) update— origin-aware update checks and self-install flows- Self-contained release binaries for macOS (arm64, x64) and Linux (x64, arm64), plus a Bun JS bundle
Changed
- Release automation publishes the npm package with provenance, attests GitHub release assets, and builds against a pinned Bun runtime.
- CI smoke-tests all released native binary targets, including macOS arm64 and x64.
- Supply-chain checks include Dependabot, CodeQL, and pull-request dependency review.