CLI Command Skeleton

The Pre-Alpha release intentionally limits the CLI surface to scaffolding that establishes naming conventions and grouping. Each command exits successfully after printing a placeholder notice so automation can exercise the interface without performing side effects.

Top-Level Options

Example output:

$ abssctl --help
Usage: abssctl [OPTIONS] COMMAND [ARGS]...

Actual Budget Multi-Instance Sync Server Admin CLI.

  This Pre-Alpha build ships with structural scaffolding only. Subcommands
  communicate planned responsibilities and will be fully implemented during
  the Alpha and Beta phases once the underlying APIs are ready.

Options:
  -V, --version  Show the abssctl version and exit.
  --help         Show this message and exit.

Subcommands

abssctl doctor — future health checks covering Actual services, nginx, and systemd units.
abssctl support-bundle — planned diagnostic archive generator.
abssctl instance — namespace for instance lifecycle operations (create, list, delete, etc.).
abssctl version — namespace for managing Actual Sync Server versions.
abssctl backup — namespace for creating and reconciling instance backups.
abssctl config — inspect configuration; config show is the first command wired to real functionality and supports --json output.

Aside from config show, commands currently emit placeholder messages. Refer to the requirements document for the eventual behaviour expectations.

Read-only commands:

version list reads versions.yml from the configured state directory and prints the entries in a table or JSON. Supply --remote to include versions reported by npm view (when available) alongside local entries.
instance list and instance show expose instances.yml contents; the latter exits with code 1 if the requested instance is missing and displays placeholder status/detail information while system probes are implemented.
version check-updates is a placeholder that confirms configuration plumbing and will be replaced with real npm lookups later in Alpha.