Directify CLI

Directify CLI

The official command-line tool for Directify lets you manage your directory directly from your terminal. Perfect for scripts, CI/CD pipelines, bulk imports, and anyone who prefers the command line over a web UI.

Installation

npm install -g directify-cli

Authentication

directify auth login

Paste your API token (generate one in Settings > API). The token is stored securely in your local config.

Optionally set a default directory so you don't need to pass --directory on every command:

directify config set default-directory <id>

Commands

The CLI mirrors the Directify API, with subcommands for each resource:

• directify directories — list your directories
• directify listings — list, get, create, update, delete, bulk create listings (alias: ls)
• directify categories — manage categories (alias: cats)
• directify tags — manage tags
• directify articles — manage blog articles (alias: blog)
• directify pages — manage custom pages
• directify organizers — manage organizers / agencies (alias: orgs)
• directify fields — list custom fields

Each resource supports: list, get, create, update, delete.

Example Commands

# List all listings as JSON
directify listings list --json

# Create a new listing
directify listings create --name "Bella Trattoria" --url "https://bella.com" --categories 5

# Bulk create from a CSV/JSON file
directify listings bulk-create --file listings.json

# Create an organizer and assign to a submitter
directify organizers create --name "Acme Events" --email "hello@acme.com" --user-id 42

# Update an article
directify articles update 123 --title "New Title" --active true

# Delete a tag
directify tags delete 7

Output Formats

• Default: clean tabular output for humans
• --json flag: machine-readable JSON for piping to jq or other tools

Key Features

• Loading spinners — visual feedback during long operations
• Colored output — green for success, red for errors
• Pagination — automatically handles paginated responses
• Bulk operations — import 100+ listings in a single command
• Scriptable — works in shell scripts, CI pipelines, cron jobs

Use Cases

• Automate listing imports from external sources
• Bulk-update listings from a spreadsheet
• Schedule recurring exports for analytics
• Migrate data between directories
• Quickly create test data for development