CLI ToolsMay 13, 2026·2 min read

dingtalk-workspace-cli — Agent-Ready DingTalk CLI

dingtalk-workspace-cli (dws) is DingTalk’s open-source CLI for humans and AI agents, with OAuth login and `--dry-run` request previews.

Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage
Agent surface
Any MCP/CLI agent
Kind
CLI Tool
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Safe staging command
npx -y tokrepo@latest install 2835c10e-b15f-59c0-a42c-268c4d3769be --target codex

Stages files first; activation requires review of the staged README and plan.

Intro

dingtalk-workspace-cli (dws) is DingTalk’s open-source CLI for humans and AI agents, with OAuth login and --dry-run request previews.

Best for: Enterprise teams automating DingTalk docs, calendar, drive, and todos

Works with: macOS/Linux/Windows, OAuth device flow, jq filtering

Setup time: 8-15 minutes

Key facts (verified)

  • GitHub: 1776 stars · 108 forks · pushed 2026-05-13.
  • License: Apache-2.0 · owner avatar + repo URL verified via GitHub API.
  • README-verified entrypoint: curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh.

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.
🙏

Source & Thanks

Source: https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli > License: Apache-2.0 > GitHub stars: 1776 · forks: 108

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets