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 loginoffers 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-core0.5.1:admin host update-settingsis described as the merge the server does, and its confirmation shows what changes and what anullremoves. - Requires
@thinger-io/cli-core0.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|describeand the type's actions (thinger endpoint call,thinger alarm rule test,thinger admin host restart…), with bodies from--fromand-s key=value,-n/-dfor the name and description, andset <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, asgh apidoes.- 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 callandthinger plugin call.product exportandproduct applykeep a product in a repository and deploy it. device list,product listandbucket listtake--search,--filter,--countand--index;device createandproduct createtake--from,-sand--projects;gettakes-f <dot.path>.thinger doc listandthinger doc get <doc>: the guides for agents from the command line.- MCP:
resource_describeshows 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 withconfirm: true(or ask through the client when it supports it);thinger mcp --read-only(orTHINGER_MCP_READ_ONLY=1) serves only what reads.
Changed (breaking)
| 0.3 | 0.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=v | thinger 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 getandproduct property getprint the property record, with its value undervalue:-fpaths start there (-f value.setpointwhere 0.3 took-f setpoint).device property listandproduct property listprint the records (-j: the records, not{ product, properties: [names] }).product property deleteasks unless-y.device resource calltakes its input from--fromand-s(-iis gone);-svalues 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
-joutputs; 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 tool | 0.4 call |
|---|---|
thinger_resource_* parent "d1" id "p1" | thinger_resource_* ids {"device": "d1", "property": "p1"} |
thinger_bucket_data_read | thinger_resource_list type "bucket_data" ids {bucket} (filter for the query) |
thinger_bucket_data_write | thinger_resource_create type "bucket_data" ids {bucket} body <samples> |
thinger_storage_file_list | thinger_resource_list type "storage_file" ids {storage} filter {path} |
thinger_storage_file_read | thinger_resource_get type "storage_file" ids {storage, file} |
thinger_storage_file_write | thinger_resource_create type "storage_file" ids {storage, file} body {content or local} |
thinger_storage_file_delete | thinger_resource_delete type "storage_file" ids {storage, file} |
thinger_device_resource_list | thinger_resource_list type "device_resource" ids {device} |
thinger_device_resource_call | thinger_resource_call type "device_resource" action "call" ids {device, resource} |
thinger_device_data_send | thinger_resource_call type "device" action "send" ids {device} body <data> |
thinger_device_overview | thinger_resource_call type "device" action "overview" |
thinger_product_resource_call | thinger_resource_call type "product_profile_api" action "call" ids {product, resource} |
thinger_plugin_call | thinger_resource_call type "plugin" action "call" ids {plugin} body {path, method} |
thinger_doc_read | thinger_resource_get type "doc" ids {doc} (thinger_resource_list type "doc" lists) |
thinger_profile_list | thinger_resource_list type "profile" |
thinger_dashboard_init / _dev / _publish | thinger_resource_call type "dashboard" action "init" / "dev" / "publish" |
- Requires
@thinger-io/cli-core0.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 fromthinger.json.thinger dashboard init <dir>: a new dashboard app from a template of@thinger-io/dashboard-sdk(React or Angular, TypeScript), with itsthinger.jsonand anAGENTS.md;--ciadds 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_initandthinger_dashboard_dev(25 tools): the same for agents, which open the dev link with their browser tools. THINGER_TOKEN(an access token) andTHINGER_SERVERreplace the saved profile in every command and the MCP server (CI), unless--profileorTHINGER_PROFILEnames one;thinger loginwarns whileTHINGER_TOKENis set.
Changed
- Requires
@thinger-io/cli-core0.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-core0.3.0:thinger_resource_callgains thealarm_instanceactionstats(how many instances there are in each state); actions check their parent and id;resource_listpages lists answered whole from anyindex. The tools are the same 23.
0.2.2
Released on 2026-10-12.
Changed
- First release of
@thinger-io/clifrom 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 stillthingerand profiles stay in~/.config/thinger-cli.
0.2.0
Released on 2026-10-10.
Changed
- Requires
@thinger-io/cli-core0.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 intools/list. Tool names change:thinger_devices→thinger_resource_listwithtype: "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-core0.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 asthinger_*. loginwith username/password (mints thethinger_cliAPI token), an existing token (non-interactive with--server --username --token) or the OAuth device flow with a client registered on the server.logoutforgets 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.