Dots Constellation Die
Docs

CLI Saved Views and Dashboard Management

Create, configure, order, duplicate, default, and delete saved views and dashboard widgets through scriptable CLI workflows.

Overview

Description

Saved Views and Dashboard Management exposes Dots' durable presentation and analysis configurations to operators and agents at the command line. dots views manages view state, flags, property settings, column widths, display configuration, ordering, and defaults. Its nested widget family creates and edits typed dashboard widgets, with ergonomic flags or raw JSON for advanced bodies.

The workflow is designed for operators and coding agents. It uses the same authenticated, company-scoped service contracts as the rest of Dots, so terminal or protocol convenience never creates a second source of truth. Inputs are validated before or at the route boundary, and outputs preserve identifiers and structured details needed for a reliable next step.

Selling Points

  • Makes complex view setup repeatable across Dotabases and environments.
  • Supports dashboards and ordinary saved views through one consistent lifecycle.
  • Lets agents choose ergonomic widget flags or provide a validated full JSON body.
  • Separates widget layout moves from content updates, reducing accidental configuration churn.
  • Allows defaults and ordering to be managed without opening each Dotabase in the UI.

User Story

An operations analyst creates a dashboard view, opts into starter widgets, adds a gauge with a target, adjusts its grid position, and sets the dashboard as default. The resulting configuration can be reproduced from the same command transcript. The result is a concrete, inspectable outcome that another person or automation can continue from without reconstructing hidden state.

Extension Surface

The surface is automatable: packages/cli/src/commands/views.ts binds the supported view and widget models. A registered SDK view type can expand the platform elsewhere, but this command tree remains closed. The rating reflects the most-open supported seam that is true for this capability, not a transitive implementation detail. The cited path is the operational proof: consumers can use the documented seam, while unsupported changes still require a core release.

Capabilities & Limits

  • Capability: Full saved-view lifecycle, ordering, default selection, flags, and display configuration.
  • Capability: Dashboard widget list, create, update, move, and delete operations.
  • Capability: Ergonomic widget construction with a raw JSON escape hatch for supported schemas.
  • Limit: The CLI can only persist view and widget types accepted by the server; runtime view registration alone does not bypass database activation and brand approval.

The limit is intentional product truth rather than missing documentation. Calls also remain subject to authentication, tenant selection, schema validation, and the permissions enforced by the authoritative service.

Implementation Map

  • packages/cli/src/commands/views.ts
  • packages/cli/src/program.ts
  • docs/cli/dotabases-commands.md

Properties

Property
Value
product
dots-platform
extensibility
automatable
module
CLI, Dotabases
packages
cli, dotabases
status
shipped
surface
cli
summary
Create, configure, order, duplicate, default, and delete saved views and dashboard widgets through scriptable CLI workflows.

Connections

CLI Saved Views and Dashboard Management · Explore connections

  • implemented bytopackages/cli/src/program.ts
  • implemented bytopackages/cli/src/commands/views.ts
  • complementstoMCP Built-In Vault Tool Catalog
  • requirestoCLI Dotabase Lifecycle and Schema Management

Connected Records4

Complements
Implemented by
packages/cli/src/commands/views.ts
packages/cli/src/program.ts
Requires
4 connections.