Skip to content

Reference

CLI changelog

Every release of the thinger CLI and its MCP server, newest first, with what each version adds, changes and fixes.

Reference7 min read

Every release of the thinger CLI (@thinger-io/cli on npm), newest first, as its changelog describes it. Each release is on GitHub; its commands are in the CLI reference and its MCP tools in MCP tools.

This page covers up to version 0.5.1.

0.5.1 ​

Released on 2026-10-31.

Changed ​

  • thinger login offers the browser login (OAuth device flow) first, with the Thinger CLI OAuth client that Thinger 7.5.0 and later create on every install. On an older server it says the client is missing and offers username and password or a token.

Fixed ​

  • From @thinger-io/cli-core 0.5.1: admin host update-settings is described as the merge the server does, and its confirmation shows what changes and what a null removes.
  • Requires @thinger-io/cli-core 0.5.1.

0.5.0 ​

Released on 2026-10-31.

Every command follows one grammar, noun first: thinger <noun> [<noun>…] <verb> [<parent ids>…] [<id>] [options]. Nouns nest under their parent (device property, product profile api), ids are positional and named after their noun, and the options keep one meaning everywhere (-j JSON, -s a body field, -f one field of the answer, -o a file, -y no questions). A few commands of 0.3 change form: see the table below. The old forms are gone, not aliased.

The MCP server serves eight tools instead of 25: thinger_resource_* reach everything by type, and records are addressed with ids. The old tool names and the parent/id arguments are gone, not aliased: see the second table below.

Added ​

  • Commands for every resource type the MCP server reaches, generated from the same catalog: list|get|create|update|delete|clone|describe and the type's actions (thinger endpoint call, thinger alarm rule test, thinger admin host restart…), with bodies from --from and -s key=value, -n/-d for the name and description, and set <property> <value> on every kind of property. Endpoints, tokens, alarms, storages, projects, assets, syncs, claims, plugins, product profiles, properties and the server administration are now reachable from the command line and from CI.
  • thinger api <path>: any request to the server, as gh api does.
  • Commands over the operations that are not CRUD: thinger bucket write|export, thinger storage file list|upload|download|delete, thinger device send|overview, thinger device resource list|call, thinger product apply --from, thinger product profile api call and thinger plugin call. product export and product apply keep a product in a repository and deploy it.
  • device list, product list and bucket list take --search, --filter, --count and --index; device create and product create take --from, -s and --projects; get takes -f <dot.path>.
  • thinger doc list and thinger doc get <doc>: the guides for agents from the command line.
  • MCP: resource_describe shows each type's ids, actions, the permission each operation needs and ready-to-send examples; actions that change a lot at once (replace_all, a host's settings or restart, removing a plugin) answer a plan and run with confirm: true (or ask through the client when it supports it); thinger mcp --read-only (or THINGER_MCP_READ_ONLY=1) serves only what reads.

Changed (breaking) ​

0.30.4
thinger device list <pattern>thinger device list --search <text>
thinger device info <device>thinger device get <device>
thinger device property <device>thinger device property list <device>
thinger device property <device> <prop>thinger device property get <device> <property>
thinger device property-set <device> <p> <v>thinger device property set <device> <property> <value>
thinger device resource <device>thinger device resource list <device>
thinger device resource <device> <r> -i k=vthinger device resource call <device> <resource> -s k=v
thinger product info <product>thinger product get <product>
thinger product property-list <product>thinger product property list <product>
thinger product property-get <product> <p>thinger product property get <product> <property>
thinger product property-set <product> <p> <v>thinger product property set <product> <property> <value>
thinger product property-delete <product> <p>thinger product property delete <product> <property> -y
  • device property get and product property get print the property record, with its value under value: -f paths start there (-f value.setpoint where 0.3 took -f setpoint). device property list and product property list print the records (-j: the records, not { product, properties: [names] }). product property delete asks unless -y. device resource call takes its input from --from and -s (-i is gone); -s values are parsed as JSON, as before.
  • The root help groups the commands as Resources, Administration, Configuration and Integration.
  • The MCP tools (the commands keep their forms and -j outputs; the help names some positionals as the server does: asset type get <type>, asset group get <group>, alarm rule get <rule>, alarm instance get <instance>, product profile <category> get <product> <resource>):
0.3 tool0.4 call
thinger_resource_* parent "d1" id "p1"thinger_resource_* ids {"device": "d1", "property": "p1"}
thinger_bucket_data_readthinger_resource_list type "bucket_data" ids {bucket} (filter for the query)
thinger_bucket_data_writethinger_resource_create type "bucket_data" ids {bucket} body <samples>
thinger_storage_file_listthinger_resource_list type "storage_file" ids {storage} filter {path}
thinger_storage_file_readthinger_resource_get type "storage_file" ids {storage, file}
thinger_storage_file_writethinger_resource_create type "storage_file" ids {storage, file} body {content or local}
thinger_storage_file_deletethinger_resource_delete type "storage_file" ids {storage, file}
thinger_device_resource_listthinger_resource_list type "device_resource" ids {device}
thinger_device_resource_callthinger_resource_call type "device_resource" action "call" ids {device, resource}
thinger_device_data_sendthinger_resource_call type "device" action "send" ids {device} body <data>
thinger_device_overviewthinger_resource_call type "device" action "overview"
thinger_product_resource_callthinger_resource_call type "product_profile_api" action "call" ids {product, resource}
thinger_plugin_callthinger_resource_call type "plugin" action "call" ids {plugin} body {path, method}
thinger_doc_readthinger_resource_get type "doc" ids {doc} (thinger_resource_list type "doc" lists)
thinger_profile_listthinger_resource_list type "profile"
thinger_dashboard_init / _dev / _publishthinger_resource_call type "dashboard" action "init" / "dev" / "publish"
  • Requires @thinger-io/cli-core 0.5.0. From this release the CLI's minor version follows the core's (0.5.x runs on cli-core 0.5.x), so there is no 0.4.0.

Fixed ​

  • Tokens created with an expiry such as "30d" (thinger_resource_create) were refused by the server: it takes milliseconds.

0.3.0 ​

Released on 2026-10-16.

Added ​

  • thinger dashboard dev [url]: develop a dashboard app on its own dev server (ng serve, Vite…) against a real server: a link with a temporary token opens the local app as a standalone page whose SDK calls the server directly.
  • thinger dashboard publish [dir]: upload the build to a public storage and point dashboards at it (--to, repeatable; --prune, --bump, --preview, --no-point). Both read their settings from thinger.json.
  • thinger dashboard init <dir>: a new dashboard app from a template of @thinger-io/dashboard-sdk (React or Angular, TypeScript), with its thinger.json and an AGENTS.md; --ci adds a GitHub workflow.
  • Publish and dev warn when the app's SDK needs a newer server, a newer SDK is on npm, or a page loads the deprecated script build.
  • MCP tools thinger_dashboard_init and thinger_dashboard_dev (25 tools): the same for agents, which open the dev link with their browser tools.
  • THINGER_TOKEN (an access token) and THINGER_SERVER replace the saved profile in every command and the MCP server (CI), unless --profile or THINGER_PROFILE names one; thinger login warns while THINGER_TOKEN is set.

Changed ​

  • Requires @thinger-io/cli-core 0.4.0.
  • The guides for agents (thinger_doc_read: concepts, product code, server administration, the dashboard SDK reference and types) ship with the CLI and the SDK package instead of coming from the server, which stops serving /sdk/. Same ids; what needs a newer server says "since Thinger X".
  • Preview links no longer come with a layout check link: the server retires /sdk/preview.html.

0.2.3 ​

Released on 2026-10-14.

Changed ​

  • @thinger-io/cli-core 0.3.0: thinger_resource_call gains the alarm_instance action stats (how many instances there are in each state); actions check their parent and id; resource_list pages lists answered whole from any index. The tools are the same 23.

0.2.2 ​

Released on 2026-10-12.

Changed ​

  • First release of @thinger-io/cli from GitHub Actions (Trusted Publishing, with provenance); 0.2.1 was published by hand to create the package.

0.2.1 ​

Released on 2026-10-12.

Changed ​

  • Published as @thinger-io/cli (formerly @thinger-io/thinger-cli, now deprecated). The command is still thinger and profiles stay in ~/.config/thinger-cli.

0.2.0 ​

Released on 2026-10-10.

Changed ​

  • Requires @thinger-io/cli-core 0.2.0: the MCP server goes from 48 tools to 23 (thinger_resource_* over a catalog of resource types, plus the operations that are not CRUD), less than half the size in tools/list. Tool names change: thinger_devices → thinger_resource_list with type: "device", thinger_profiles → thinger_profile_list, thinger_bucket_read → thinger_bucket_data_read, and so on.
  • MCP instructions rewritten for the new tools.

0.1.1 ​

Released on 2026-10-10.

Changed ​

  • Requires @thinger-io/cli-core 0.1.1. First release published from GitHub Actions through Trusted Publishing.

0.1.0 ​

Released on 2026-10-10.

First version: the thinger CLI, built on @thinger-io/cli-core (the generic core of ThinRemote's thinr, made independent of the product).

Added ​

  • Thinger identity: profiles in ~/.config/thinger-cli, THINGER_PROFILE / THINGER_INSECURE, MCP tools as thinger_*.
  • login with username/password (mints the thinger_cli API token), an existing token (non-interactive with --server --username --token) or the OAuth device flow with a client registered on the server.
  • logout forgets the current profile (or --all) and revokes the API token the CLI created.
  • Commands: device (list, info, create, delete, set-product, property, property-set, resource), product (list, info, create, delete, property-list, property-get, property-set, property-delete), bucket (list, read), profile.
  • thinger mcp: devices, resources, properties, products, product profiles, buckets, tokens, alarms and profiles.