dingtalk-workspace-cli — Agent-Ready DingTalk CLI

Main

• Use --dry-run when wiring it into an agent: you can preview requests without mutating enterprise data.

• Prefer device-flow auth (dws auth login --device) for headless environments (SSH/CI) and browser auth for local desktops.

• Explore capability via dws schema — README shows jq filters to inspect tool counts and parameter schemas before calling APIs.

Source-backed notes

• README highlights --dry-run and multiple output formats (-f table/json/raw) as human+agent friendly defaults.
• README Installation section includes a one-line curl install script and mentions Go 1.25+ for building from source.
• README Quick Start lists example commands across contacts, calendar, docs, minutes, drive, and todo tools.

FAQ

• Is it safe to run in production orgs?: README stresses least-privilege and audit; still start with --dry-run to validate requests.
• Do I need admin permissions?: README notes enterprise data access may require admin authorization depending on your org setup.
• How do agents discover tools?: Use dws schema — README shows jq queries to inspect tool lists and parameters.