The watermint toolbox is the multi-purpose utility command-line tool for web services including Dropbox, Figma, GitHub, etc. The purpose of the tool is to provide users of cloud services and system administrators with a way to automate workflows and provide a work-around for some issues.
watermint toolbox is licensed under the Apache License, Version 2.0. Please see LICENSE.md or LICENSE.txt for more detail.
Please carefully note:
Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
Pre-compiled binaries can be found in Latest Release. If you are building directly from the source, please refer BUILD.md.
First, you need to install Homebrew. Please refer the instruction on the official site. Then run following commands to install watermint toolbox.
brew tap watermint/toolbox
brew install toolbox
This product itself is experimental and is not subject to the maintained to keep quality of service. The project will attempt to fix critical bugs and security issues with the best effort. But that is also not guaranteed.\n\nThe product will not release any patch release of a certain major releases. The product will apply fixes as next release when those fixes accepted to do.
The deliverables of this project are stand-alone executable programs. The specification changes will not be applied unless you explicitly upgrade your version of the program.\n\nThe following policy will be used to make changes in new version releases.\n\nCommand paths, arguments, return values, etc. will be upgraded to be as compatible as possible, but may be discontinued or changed. The general policy is as follows.\n\n* Changes that do not break existing behavior, such as the addition of arguments or changes to messages, will be implemented without notice.\n* Commands that are considered infrequently used will be discontinued or moved without notice.\n* Changes to other commands will be announced 30-180 days or more in advance.\n\nChanges in specifications will be announced at Announcements. Please refer to Specification Change for a list of planned specification changes.\n
In general, new security issues are discovered every day. To avoid leaving these security and critical issues unaddressed by continuing to use older watermint toolbox releases, a maximum availability period has been set for release 130 and above. Please see #815 for more details.
- #906 AI Powered Q&A Bot on ChatGPT
- #905 Deprecation: Some of utilities command will be removed after release of 2025-08-01
The watermint toolbox is designed to simplify the use of cloud service APIs. It will not use the data in any way that is contrary to your intentions.
The watermint toolbox does not store the data it retrieves via the linked cloud service API on a separate server, contrary to the intent of the specified command.
For example, if you use the watermint toolbox to retrieve data from a cloud service, those data will only be stored on your PC. Furthermore, in the case of commands that upload files or data to a cloud service, they will only be stored in the location specified by your account.
When you use the watermint toolbox to retrieve data from the cloud service API, your data is stored on your PC as report data or log data. More sensitive information, such as the authentication token for the cloud service API, is also stored on your PC.
It is your responsibility to keep these data stored on your PC secure.
Important information such as authentication tokens are obfuscated so that their contents cannot be easily read. However, this obfuscation is not intended to enhance security, but to prevent unintentional operational errors. If a malicious third party copies your token information to another PC, they may be able to access cloud services that you did not intend.
As previously stated, the watermint toolbox is designed to store data on your PC or in your cloud account. Processes other than your intended operation include data retrieval for release lifecycle management, as outlined below.
The watermint toolbox has the capability to deactivate specific releases that have critical bugs or security issues. This is achieved by retrieving data from a repository hosted on GitHub approximately every 30 days to assess the status of a release. This access does not collect any private data (such as your cloud account information, local files, token, etc.). It merely checks the release status, but as a side effect, your IP address is sent to GitHub when downloading data.
Please be aware that this access information (date, time and IP address) may be used in the future to estimate the usage of each release.
The watermint toolbox project does not currently manage or obtain data including IP addresses, information that only GitHub, the company that hosts the project, has the possibility to access. However, the project may in the future make this information available, and may disclose anonymised release-by-release usage to project members if deemed necessary for the operation of the project.
Any such changes will be announced on the announcement page and this security & privacy policy page at least 30 days before the change takes effect.
tbx
has various features. Run without an option for a list of supported commands and options.\nYou can see available commands and options by running the executable without arguments as shown below.
% ./tbx
watermint toolbox xx.x.xxx
==========================
© 2016-2025 Takayuki Okazaki
Licensed under open source licenses. Use the `license` command for more detail.
Tools for Dropbox and Dropbox for Teams
Usage:
======
./tbx command
Available commands:
===================
| Command | Description | Notes |
|---------|--------------------------|-------|
| asana | Asana commands | |
| config | CLI configuration | |
| deepl | DeepL commands | |
| dropbox | Dropbox commands | |
| figma | Figma commands | |
| github | GitHub commands | |
| license | Show license information | |
| local | Commands for local PC | |
| log | Log utilities | |
| slack | Slack commands | |
| util | Utilities | |
| version | Show version | |
Command | Description |
---|---|
deepl translate text | Translate text |
Command | Description |
---|---|
dropbox file account feature | List Dropbox account features |
dropbox file account filesystem | Show Dropbox file system version |
dropbox file account info | Dropbox account info |
dropbox file compare account | Compare files of two accounts |
dropbox file compare local | Compare local folders and Dropbox folders |
dropbox file copy | Copy files |
dropbox file delete | Delete file or folder |
dropbox file export doc | Export document |
dropbox file export url | Export a document from the URL |
dropbox file import batch url | Batch import files from URL |
dropbox file import url | Import file from the URL |
dropbox file info | Resolve metadata of the path |
dropbox file list | List files and folders |
dropbox file lock acquire | Lock a file |
dropbox file lock all release | Release all locks under the specified path |
dropbox file lock batch acquire | Lock multiple files |
dropbox file lock batch release | Release multiple locks |
dropbox file lock list | List locks under the specified path |
dropbox file lock release | Release a lock |
dropbox file merge | Merge paths |
dropbox file move | Move files |
dropbox file replication | Replicate file content to the other account |
dropbox file request create | Create a file request |
dropbox file request delete closed | Delete all closed file requests on this account. |
dropbox file request delete url | Delete a file request by the file request URL |
dropbox file request list | List file requests of the individual account |
dropbox file restore all | Restore files under given path |
dropbox file restore ext | Restore files with a specific extension |
dropbox file revision download | Download the file revision |
dropbox file revision list | List file revisions |
dropbox file revision restore | Restore the file revision |
dropbox file search content | Search file content |
dropbox file search name | Search file name |
dropbox file share info | Retrieve sharing information of the file |
dropbox file sharedfolder info | Get shared folder info |
dropbox file sharedfolder leave | Leave the shared folder |
dropbox file sharedfolder list | List shared folders |
dropbox file sharedfolder member add | Add a member to the shared folder |
dropbox file sharedfolder member delete | Remove a member from the shared folder |
dropbox file sharedfolder member list | List shared folder members |
dropbox file sharedfolder mount add | Add the shared folder to the current user's Dropbox |
dropbox file sharedfolder mount delete | Unmount the shared folder |
dropbox file sharedfolder mount list | List all shared folders the current user has mounted |
dropbox file sharedfolder mount mountable | List all shared folders the current user can mount |
dropbox file sharedfolder share | Share a folder |
dropbox file sharedfolder unshare | Unshare a folder |
dropbox file sharedlink create | Create shared link |
dropbox file sharedlink delete | Remove shared links |
dropbox file sharedlink file list | List files for the shared link |
dropbox file sharedlink info | Get information about the shared link |
dropbox file sharedlink list | List shared links |
dropbox file size | Storage usage |
dropbox file sync down | Downstream sync with Dropbox |
dropbox file sync online | Sync online files |
dropbox file sync up | Upstream sync with Dropbox |
dropbox file tag add | Add tag to file or folder |
dropbox file tag delete | Delete a tag from the file/folder |
dropbox file tag list | List tags of the path |
dropbox file template apply | Apply file/folder structure template to the Dropbox path |
dropbox file template capture | Capture file/folder structure as template from Dropbox path |
dropbox file watch | Watch file activities |
dropbox paper append | Append the content to the end of the existing Paper doc |
dropbox paper create | Create new Paper in the path |
dropbox paper overwrite | Overwrite an existing Paper document |
dropbox paper prepend | Append the content to the beginning of the existing Paper doc |
util tidy pack remote | Package remote folder into the zip file |
Command | Description |
---|---|
dropbox sign request list | List signature requests |
dropbox sign request signature list | List signatures of requests |
Command | Description |
---|---|
dropbox team activity batch user | Scan and retrieve activity logs for multiple team members in batch, useful for compliance auditing and user behavior analysis |
dropbox team activity daily event | Generate daily activity reports showing team events grouped by date, helpful for tracking team usage patterns and security monitoring |
dropbox team activity event | Retrieve detailed team activity event logs with filtering options, essential for security auditing and compliance monitoring |
dropbox team activity user | Retrieve activity logs for specific team members, showing their file operations, logins, and sharing activities |
dropbox team admin group role add | Assign admin roles to all members of a specified group, streamlining role management for large teams |
dropbox team admin group role delete | Remove admin roles from all team members except those in a specified exception group, useful for role cleanup and access control |
dropbox team admin list | Display all team members with their assigned admin roles, helpful for auditing administrative access and permissions |
dropbox team admin role add | Grant a specific admin role to an individual team member, enabling granular permission management |
dropbox team admin role clear | Revoke all administrative privileges from a team member, useful for role transitions or security purposes |
dropbox team admin role delete | Remove a specific admin role from a team member while preserving other roles, allowing precise permission adjustments |
dropbox team admin role list | Display all available admin roles in the team with their descriptions and permissions |
dropbox team backup device status | Track Dropbox Backup status changes for all team devices over a specified period, monitoring backup health and compliance |
dropbox team content legacypaper count | Calculate the total number of legacy Paper documents owned by each team member, useful for content auditing and migration planning |
dropbox team content legacypaper export | Export all legacy Paper documents from team members to local storage in HTML or Markdown format for backup or migration |
dropbox team content legacypaper list | Generate a comprehensive list of all legacy Paper documents across the team with ownership and metadata information |
dropbox team content member list | Display all members with access to team folders and shared folders, showing permission levels and folder relationships |
dropbox team content member size | Calculate member counts for each team folder and shared folder, helping identify heavily accessed content and optimize permissions |
dropbox team content mount list | Display mount status of all shared folders for team members, identifying which folders are actively synced to member devices |
dropbox team content policy list | Review all access policies and restrictions applied to team folders and shared folders for governance compliance |
dropbox team device list | Display all devices and active sessions connected to team member accounts with device details and last activity timestamps |
dropbox team device unlink | Remotely disconnect devices from team member accounts, essential for securing lost/stolen devices or revoking access |
dropbox team feature | Display all features and capabilities enabled for your Dropbox team account, including API limits and special features |
dropbox team filerequest list | Display all active and closed file requests created by team members, helping track external file collection activities |
dropbox team filesystem | Identify whether your team uses legacy or modern file system architecture, important for feature compatibility |
dropbox team group add | Create a new group in your team for organizing members and managing permissions collectively |
dropbox team group batch add | Create multiple groups at once using batch processing, efficient for large-scale team organization |
dropbox team group batch delete | Remove multiple groups from your team in batch, streamlining group cleanup and reorganization |
dropbox team group clear externalid | Remove external ID mappings from groups, useful when disconnecting from external identity providers |
dropbox team group delete | Remove a specific group from your team, automatically removing all member associations |
dropbox team group folder list | Display all folders accessible by each group, showing group-based content organization and permissions |
dropbox team group list | Display all groups in your team with member counts and group management types |
dropbox team group member add | Add individual team members to a specific group for centralized permission management |
dropbox team group member batch add | Add multiple members to groups efficiently using batch processing, ideal for large team reorganizations |
dropbox team group member batch delete | Remove multiple members from groups in batch, streamlining group membership management |
dropbox team group member batch update | Update group memberships in bulk by adding or removing members, optimizing group composition changes |
dropbox team group member delete | Remove a specific member from a group while preserving their other group memberships |
dropbox team group member list | Display all members belonging to each group, useful for auditing group compositions and access rights |
dropbox team group rename | Change the name of an existing group to better reflect its purpose or organizational changes |
dropbox team group update type | Change how a group is managed (user-managed vs company-managed), affecting who can modify group membership |
dropbox team info | Display essential team account information including team ID and basic team settings |
dropbox team insight scan | Perform comprehensive data scanning across your team for analytics and insights generation |
dropbox team legalhold add | Create a legal hold policy to preserve specified team content for compliance or litigation purposes |
dropbox team legalhold list | Display all active legal hold policies with their details, members, and preservation status |
dropbox team legalhold member batch update | Add or remove multiple team members from legal hold policies in batch for efficient compliance management |
dropbox team legalhold member list | Display all team members currently under legal hold policies with their preservation status |
dropbox team legalhold release | Release a legal hold policy and restore normal file operations for affected members and content |
dropbox team legalhold revision list | Display all file revisions preserved under legal hold policies, ensuring comprehensive data retention |
dropbox team legalhold update desc | Modify the description of an existing legal hold policy to reflect changes in scope or purpose |
dropbox team legalhold update name | Change the name of a legal hold policy for better identification and organization |
dropbox team linkedapp list | Display all third-party applications linked to team member accounts for security auditing and access control |
dropbox team member batch delete | Remove multiple team members in batch, efficiently managing team departures and access revocation |
dropbox team member batch detach | Convert multiple team accounts to individual Basic accounts, preserving personal data while removing team access |
dropbox team member batch invite | Send batch invitations to new team members, streamlining the onboarding process for multiple users |
dropbox team member batch reinvite | Resend invitations to pending members who haven't joined yet, ensuring all intended members receive access |
dropbox team member batch suspend | Temporarily suspend multiple team members' access while preserving their data and settings |
dropbox team member batch unsuspend | Restore access for multiple suspended team members, reactivating their accounts in batch |
dropbox team member clear externalid | Remove external ID mappings from team members, useful when disconnecting from identity management systems |
dropbox team member feature | Display feature settings and capabilities enabled for specific team members, helping understand member permissions |
dropbox team member file lock all release | Release all file locks held by a team member under a specified path, resolving editing conflicts |
dropbox team member file lock list | Display all files locked by a specific team member under a given path, identifying potential collaboration blocks |
dropbox team member file lock release | Release a specific file lock held by a team member, enabling others to edit the file |
dropbox team member file permdelete | Permanently delete files or folders from a team member's account, bypassing trash for immediate removal |
dropbox team member folder list | Display all folders in each team member's account, useful for content auditing and storage analysis |
dropbox team member folder replication | Copy folder contents from one team member to another's personal space, facilitating content transfer and backup |
dropbox team member list | Display comprehensive list of all team members with their status, roles, and account details |
dropbox team member quota batch update | Modify storage quotas for multiple team members in batch, managing storage allocation efficiently |
dropbox team member quota list | Display storage quota assignments for all team members, helping monitor and plan storage distribution |
dropbox team member quota usage | Show actual storage usage for each team member compared to their quotas, identifying storage needs |
dropbox team member replication | Replicate all files from one team member's account to another, useful for account transitions or backups |
dropbox team member suspend | Temporarily suspend a team member's access to their account while preserving all data and settings |
dropbox team member unsuspend | Restore access for a suspended team member, reactivating their account and all associated permissions |
dropbox team member update batch email | Update email addresses for multiple team members in batch, managing email changes efficiently |
dropbox team member update batch externalid | Set or update external IDs for multiple team members, integrating with identity management systems |
dropbox team member update batch invisible | Hide team members from the directory listing, enhancing privacy for sensitive roles or contractors |
dropbox team member update batch profile | Update profile information for multiple team members including names and job titles in batch |
dropbox team member update batch visible | Make hidden team members visible in the directory, restoring standard visibility settings |
dropbox team namespace file list | Display comprehensive file and folder listings within team namespaces for content inventory and analysis |
dropbox team namespace file size | Calculate storage usage for files and folders in team namespaces, providing detailed size analytics |
dropbox team namespace list | Display all team namespaces including team folders and shared spaces with their configurations |
dropbox team namespace member list | Show all members with access to each namespace, detailing permissions and access levels |
dropbox team namespace summary | Generate comprehensive summary reports of team namespace usage, member counts, and storage statistics |
dropbox team runas file batch copy | Copy multiple files or folders on behalf of team members, useful for content management and organization |
dropbox team runas file list | List files and folders in a team member's account by running operations as that member |
dropbox team runas file sync batch up | Upload multiple local files to team members' Dropbox accounts in batch, running as those members |
dropbox team runas sharedfolder batch leave | Remove team members from multiple shared folders in batch by running leave operations as those members |
dropbox team runas sharedfolder batch share | Share multiple folders on behalf of team members in batch, automating folder sharing processes |
dropbox team runas sharedfolder batch unshare | Remove sharing from multiple folders on behalf of team members, managing folder access in bulk |
dropbox team runas sharedfolder isolate | Remove all shared folder access for a team member and transfer ownership, useful for departing employees |
dropbox team runas sharedfolder list | Display all shared folders accessible by a team member, running the operation as that member |
dropbox team runas sharedfolder member batch add | Add multiple members to shared folders in batch on behalf of folder owners, streamlining access management |
dropbox team runas sharedfolder member batch delete | Remove multiple members from shared folders in batch on behalf of folder owners, managing access efficiently |
dropbox team runas sharedfolder mount add | Mount shared folders to team members' accounts on their behalf, ensuring proper folder synchronization |
dropbox team runas sharedfolder mount delete | Unmount shared folders from team members' accounts on their behalf, managing folder synchronization |
dropbox team runas sharedfolder mount list | Display all shared folders currently mounted (synced) to a specific team member's account |
dropbox team runas sharedfolder mount mountable | Show all available shared folders that a team member can mount but hasn't synced yet |
dropbox team sharedlink cap expiry | Apply expiration date limits to all team shared links for enhanced security and compliance |
dropbox team sharedlink cap visibility | Enforce visibility restrictions on team shared links, controlling public access levels |
dropbox team sharedlink delete links | Delete multiple shared links in batch for security compliance or access control cleanup |
dropbox team sharedlink delete member | Remove all shared links created by a specific team member, useful for departing employees |
dropbox team sharedlink list | Display comprehensive list of all shared links created by team members with visibility and expiration details |
dropbox team sharedlink update expiry | Modify expiration dates for existing shared links across the team to enforce security policies |
dropbox team sharedlink update password | Add or change passwords on team shared links in batch for enhanced security protection |
dropbox team sharedlink update visibility | Change access levels of existing shared links between public, team-only, and password-protected |
dropbox team teamfolder add | Create a new team folder for centralized team content storage and collaboration |
dropbox team teamfolder archive | Archive a team folder to make it read-only while preserving all content and access history |
dropbox team teamfolder batch archive | Archive multiple team folders in batch, efficiently managing folder lifecycle and compliance |
dropbox team teamfolder batch permdelete | Permanently delete multiple archived team folders in batch, freeing storage space |
dropbox team teamfolder batch replication | Replicate multiple team folders to another team account in batch for migration or backup |
dropbox team teamfolder file list | Display all files and subfolders within team folders for content inventory and management |
dropbox team teamfolder file lock all release | Release all file locks within a team folder path, resolving editing conflicts in bulk |
dropbox team teamfolder file lock list | Display all locked files within team folders, identifying collaboration bottlenecks |
dropbox team teamfolder file lock release | Release specific file locks in team folders to enable collaborative editing |
dropbox team teamfolder file size | Calculate storage usage for team folders, providing detailed size analytics for capacity planning |
dropbox team teamfolder list | Display all team folders with their status, sync settings, and member access information |
dropbox team teamfolder member add | Add multiple users or groups to team folders in batch, streamlining access provisioning |
dropbox team teamfolder member delete | Remove multiple users or groups from team folders in batch, managing access revocation efficiently |
dropbox team teamfolder member list | Display all members with access to each team folder, showing permission levels and access types |
dropbox team teamfolder partial replication | Selectively replicate team folder contents to another team, enabling flexible content migration |
dropbox team teamfolder permdelete | Permanently delete an archived team folder and all its contents, irreversibly freeing storage |
dropbox team teamfolder policy list | Display all access policies and restrictions applied to team folders for governance review |
dropbox team teamfolder replication | Copy an entire team folder with all contents to another team account for migration or backup |
dropbox team teamfolder sync setting list | Display sync configuration for all team folders, showing default sync behavior for members |
dropbox team teamfolder sync setting update | Modify sync settings for multiple team folders in batch, controlling automatic synchronization behavior |
Command | Description |
---|---|
figma account info | Retrieve current user information |
figma file export all page | Export all files/pages under the team |
figma file export frame | Export all frames of the Figma file |
figma file export node | Export Figma document Node |
figma file export page | Export all pages of the Figma file |
figma file info | Show information of the Figma file |
figma file list | List files in the Figma Project |
figma project list | List projects of the team |
Command | Description |
---|---|
github content get | Get content metadata of the repository |
github content put | Put small text content into the repository |
github issue list | List issues of the public/private GitHub repository |
github profile | Get the authenticated user |
github release asset download | Download assets |
github release asset list | List assets of GitHub Release |
github release asset upload | Upload assets file into the GitHub Release |
github release draft | Create release draft |
github release list | List releases |
github tag create | Create a tag on the repository |
util release install | Download & install watermint toolbox to the path |
Command | Description |
---|---|
config auth delete | Delete existing auth credential |
config auth list | List all auth credentials |
config feature disable | Disable a feature. |
config feature enable | Enable a feature. |
config feature list | List available optional features. |
config license install | Install a license key |
config license list | List available license keys |
dropbox team insight report teamfoldermember | Generate detailed reports on team folder membership, showing access patterns and member distribution |
license | Show license information |
local file template apply | Apply file/folder structure template to the local path |
local file template capture | Capture file/folder structure as template from local path |
log api job | Show statistics of the API log of the job specified by the job ID |
log api name | Show statistics of the API log of the job specified by the job name |
log cat curl | Format capture logs as curl sample |
log cat job | Retrieve logs of specified Job ID |
log cat kind | Concatenate and print logs of specified log kind |
log cat last | Print the last job log files |
log job archive | Archive jobs |
log job delete | Delete old job history |
log job list | Show job history |
util archive unzip | Extract the zip archive file |
util archive zip | Compress target files into the zip archive |
util cert selfsigned | Generate self-signed certificate and key |
util database exec | Execute query on SQLite3 database file |
util database query | Query SQLite3 database |
util date today | Display current date |
util datetime now | Display current date/time |
util decode base32 | Decode text from Base32 (RFC 4648) format |
util decode base64 | Decode text from Base64 (RFC 4648) format |
util desktop open | Open a file or folder with the default application |
util encode base32 | Encode text into Base32 (RFC 4648) format |
util encode base64 | Encode text into Base64 (RFC 4648) format |
util feed json | Load feed from the URL and output the content as JSON |
util file hash | File Hash |
util git clone | Clone git repository |
util image exif | Print EXIF metadata of image file |
util image placeholder | Create placeholder image |
util json query | Query JSON data |
util net download | Download a file |
util qrcode create | Create a QR code image file |
util qrcode wifi | Generate QR code for WIFI configuration |
util table format xlsx | Formatting xlsx file into text |
util text case down | Print lower case text |
util text case up | Print upper case text |
util text encoding from | Convert text encoding to UTF-8 text file from specified encoding. |
util text encoding to | Convert text encoding to specified encoding from UTF-8 text file. |
util text nlp english entity | Split English text into entities |
util text nlp english sentence | Split English text into sentences |
util text nlp english token | Split English text into tokens |
util text nlp japanese token | Tokenize Japanese text |
util text nlp japanese wakati | Wakachigaki (tokenize Japanese text) |
util tidy move dispatch | Dispatch files |
util tidy move simple | Archive local files |
util time now | Display current time |
util unixtime format | Time format to convert the unix time (epoch seconds from 1970-01-01) |
util unixtime now | Display current time in unixtime |
util uuid timestamp | UUID Timestamp |
util uuid ulid | ULID Utility |
util uuid v4 | Generate UUID v4 (random UUID) |
util uuid v7 | Generate UUID v7 |
util uuid version | Parse version and variant of UUID |
util xlsx create | Create an empty spreadsheet |
util xlsx sheet export | Export data from the xlsx file |
util xlsx sheet import | Import data into xlsx file |
util xlsx sheet list | List sheets of the xlsx file |
version | Show version |