SchedPlus command-line reference

The CLI uses the same validation and SQLite backend as the desktop interfaces. Successful commands write their result to standard output; validation errors return exit code 2, and database or update failures return 1.

Install the Debian schedplus-cli package for a CLI-only Linux build, or use the CLI portable ZIP on Windows; both launch schedplus-cli directly. The flexible schedplus launcher also accepts the commands below when using a Full source installation.

Task commands

# Create
schedplus add "Buy milk" --date 2026-08-20 --time 14:00

# List (default order is date)
schedplus list
schedplus list --sort time --descending

# Change one or more fields
schedplus edit 7c94a2 --text "Buy milk and bread" --time 15:00

# Delete
schedplus delete 7c94a2

list --sort accepts date, time, or text; --descending reverses the selected order. edit requires at least one of --text, --date, or --time.

Task IDs are UUIDs. For editing and deleting, you may provide the full ID or an unambiguous beginning of it. SchedPlus refuses ambiguous or unknown prefixes to prevent modifying the wrong task.

Updates

schedplus update status
schedplus update check
schedplus update install
schedplus update rollback

These commands are intended for a compatible, managed packaged build. Source checkouts, Snap packages, and Microsoft Store packages do not self-update; their update provider or development workflow manages updates instead.

Use schedplus --help or schedplus COMMAND --help for the command parser’s complete help. The legacy schedplus --raw ... form remains available as a compatibility alias for direct CLI commands.