CLI Reference

The formdata-dev CLI manages your formdata.dev account, forms, and destinations from the terminal.

Installation

No install required. Run directly with npx:

npx formdata-dev <command>

Version

npx formdata-dev --version
# 0.2.0

Credentials

The CLI stores credentials at ~/.config/formdata/credentials (or $XDG_CONFIG_HOME/formdata/credentials). The file is chmod 600 and contains your secret key, API URL, organization name, and slug.

Credentials are created during init and updated during keys rotate.

Command Reference

Account

Command Description
init Create account and store credentials
status Account overview with all forms and destinations
keys rotate Rotate secret key (invalidates old key)

Forms

Command Description
forms list List all forms
forms create Create a new form (interactive)
forms get <id> Show form details and destinations
forms update <id> Update form settings
forms delete <id> Delete a form

Destinations

Command Description
destinations list List destinations for a form
destinations add Add a destination to a form
destinations rm <formId> <destId> Remove a destination

Options

Flag Description
--help, -h Show help message
--version, -v Show version
TIP

Every CLI command has an equivalent MCP tool. See the MCP Reference to manage forms through AI assistants instead.