Developer interface
Closed Alpha

doss/cli

One command surface for DOSS

Build and operate DOSS from one command surface.

Scope

What it does.

doss/cli exposes the same command registry to people, shell scripts, and agents. Help, JSON output, MCP tools, previews, approvals, and apply behavior come from the command definition rather than separate wrappers.

doss/cli / System architecture

Humans and agents use the same commands.

doss/cli generates help, completion, JSON output, MCP exposure, and risk behavior from one command registry. The interface changes by transport; command meaning does not.

control
execution
state
Evidence
Human terminal
Agent / MCP
CI + scripts
Console + extensions
->
One live command registry
Command meaning is transport-independent

Schema, examples, risk, output mode, capability requirements, help, completion, and MCP projection are defined once.

Typed arguments
Auth profiles
JSON / JSONL envelopes
Bounded watches
Capability packs
Audit identity
->
Low risk
Read + inspect
Discover
Query
Describe
Watch
Effectful
Plan + apply
Diff first
Explicit apply
Policy gate
Rollback contract
Platform adapters
Build + deploy
CENTARI + DOSSBOT
Tapestry + Tesseract
Logs + smoke + rollback
Outputs
Human-readable result
Machine-stable envelope
Audited platform effect
What feeds back

Exit codes, structured errors, and smoke results tell a person or agent what to do next.

Responsibilities

What it owns

01

One registry

Generate help, completion, JSON output, and MCP tools from the same command definition.

02

Stable output

Use JSON, JSONL, pagination, watches, timeouts, and explicit apply flags in automation.

03

Full release path

Initialize, validate, plan, deploy, inspect logs, smoke test, and roll back.

04

Call the owner

Route each command to Tapestry, Tesseract, DOSSBOT, CENTARI, or the build system.

Dependencies

What it connects to

doss/cli calls these products and services directly.

DOSS Labs

Talk to us about doss/cli.

Get in touch