SenseCraft CLI
Your AI agent may be great at reasoning, but without access to your tools, it cannot take action in SenseCraft. It cannot list your devices, read a sensor, publish an app, or deploy a model.
SenseCraft CLI (sensecraft-cli) connects your AI — or your own
terminal — to the SenseCraft platform, so real work gets
done: manage devices and telemetry, build and publish applications and
models, and deploy to cloud devices. You stay in control: every sensitive
action is confirmed with you before it runs.
npx @seeed-studio/sensecraft-cli install # one-time setupSenseCraft CLI is open source — the code, skills, and issue tracker live at github.com/Seeed-Solution/sensecraft-cli.
Why SenseCraft CLI?
Section titled “Why SenseCraft CLI?”- Agent-native design — ships with ready-made skills (
SKILL.md) for Claude Code, Codex, Cursor, opencode, pi and any host that runs shell commands; zero extra setup for agents - Wide coverage — 8 command families across SenseCraft Data, SenseCraft AI and CodeCraft Hub: devices, groups, telemetry, apps, models, files, cloud deployment, reCamera
- AI-friendly output — every command prints machine-readable JSON with
non-zero exits on failure; agents and
jqpipelines work out of the box - Secure and controllable — sensitive writes are gated behind an
explicit
--yesafter the agent asks you in chat; commands don’t print stored secrets, and agents are told to mask them - Up and running in 3 minutes — one install command, one browser approval, and your first task runs
Getting started
Section titled “Getting started”Two ways in, both three steps — see Getting started:
| Path | Steps |
|---|---|
| With an AI agent (fastest) | Install → authorize with auth init → describe what you want |
| Manually | Install → authorize → run commands |
Your first task, pasted straight into an agent:
Check my SenseCraft CLI auth status, then list my devices with theirnames and EUIs.Capability map
Section titled “Capability map”| Domain | What your agent can do |
|---|---|
| Devices | List, view, bind and unbind SenseCraft Data devices; inspect channels and status; check SIM cards; create dev kits |
| Groups | Organize devices into groups, rename, move devices, clean up |
| Sensor data | Read latest readings, raw history, and chart aggregation for any node |
| Applications | CodeCraft Hub: browse and search public apps; create, update, publish, unpublish, withdraw and delete your apps; author from a local project with the create-app manifest workflow; manage bills of materials |
| Models | Search the library and your models; upload and version artifacts; publish, unpublish, delete; resolve reCamera Pro compatibility |
| Files | Upload images, model binaries, firmware, docs and archives; attach them to models and apps |
| Training | Create classification, detection, audio, auto-label and reCamera jobs; monitor, stop, download artifacts; compile Aily firmware |
| Cloud devices | List Jetson-class kits; deploy models and track deployment orders |
| reCamera | Pick apps and models for the classic reCamera and open the flash page |
Where to go next
Section titled “Where to go next”| I want to… | Read |
|---|---|
| Get started — with an agent or manually | Getting started |
| Wire skills into your agent | Skills |
Requirements at a glance
Section titled “Requirements at a glance”- Node.js ≥ 16 (18 or 20 LTS recommended) for installation via npm/npx.
- macOS (Intel/Apple Silicon), Linux (x64/arm64), or Windows (x64/arm64).
- A Seeed account on the site you authenticate against, and an Access Key created in the account center — or the browser wizard. SenseCraft AI and CodeCraft Hub need a Global account; the China site is SenseCraft Data only.
- Building from source additionally requires Go (see Installation).