Directify CLI — Manage Your Directory from the Terminal

What is the CLI?

directify is the official command-line tool. It wraps the Directify REST API so you can manage your directory from your terminal, shell scripts, or CI pipelines — no AI required. It’s ideal for power users and automation.

Install

Requires Node.js 18+.

npm install -g directify-cli

Or run it without installing, using npx:

npx directify-cli --help

Connect

Get your API token

In your Directify dashboard, go to Settings → API and click the Key icon to generate a token.

Authenticate

directify auth login YOUR_API_TOKEN

Your token is stored locally so you only do this once.

Set a default directory

# Find your directory IDs
directify directories list

# Set the default so you don't pass --directory every time
directify config set-directory 123

Start managing

# Listings
directify listings list
directify listings create --name "Bella Trattoria" --description "Authentic Italian cuisine" --categories 1,5 --organizers 8

# Time-limited listings (hidden until --starts-at, expires at --ends-at)
directify listings update 456 --starts-at "2026-08-01 09:00:00" --ends-at "2026-09-01 09:00:00"

# Categories & tags
directify categories create --title "Italian" --icon "🍝"
directify tags create --title "Featured"

# Custom fields
directify fields create --label "Price Range" --type select --options "$,$$,$$$" --filterable
directify fields list

# Articles & pages
directify articles list
directify pages create --title "About Us" --placement navbar

Every command supports --help, and most accept -d, --directory <id> to target a specific directory (overriding the default) and --json for machine-readable output.

The CLI mirrors the API one-to-one. If a command errors with a validation message, it’s coming straight from the API — see Authentication → Error Responses for what each status code means.

Common command groups

Group	Commands
`auth`	`login`, `logout`, `status`
`config`	`set-directory`, `get-directory`
`directories`	`list`
`languages`	`list`
`listings`	`list`, `get`, `create`, `update`, `delete`, `exists`, `bulk-create`
`categories`	`list`, `get`, `create`, `update`, `delete`
`tags`	`list`, `get`, `create`, `update`, `delete`
`fields`	`list`, `get`, `create`, `update`, `delete`
`organizers`	`list`, `get`, `create`, `update`, `delete`
`articles`	`list`, `get`, `create`, `update`, `delete`, `toggle`
`pages`	`list`, `get`, `create`, `update`, `delete`, `toggle`

Run directify --help (or directify <group> --help) to see every command and option.

Multilingual directories

On directories with more than one language (requires CLI 1.6.0 or later):

# See the directory's languages
directify languages list

# Read in a language
directify listings list --locale es
directify categories get 12 --locale de

# Write translations (repeat --translate for each field)
directify listings update 42 --translate es.name="Café de Joe" --translate es.description="Café de especialidad"

# Or pass them all as JSON
directify categories update 12 --translations '{"es": {"title": "Cafeterías"}, "de": {"title": "Cafés"}}'

# Remove a translation (falls back to the original text)
directify listings update 42 --translate es.name=null

# A listing whose own text is in Spanish
directify listings create --name "Café Azul" --source-locale es --translate en.name="Blue Café"

Bulk-create files can include translations and source_locale per listing. Each command’s --help lists the fields it can translate; see Languages & Translations for details.

Want to manage your directory by chatting with an AI assistant instead? See the MCP Server guide.

Get Started

Directories

Listings

Categories

Integrations

Ads

Forms

Settings

Paid Submissions

Blog

Content

Custom Pages/Links

AI & Automation

API

Directify CLI — Manage Your Directory from the Terminal

What is the CLI?

Install

Connect

Start managing

Common command groups

Multilingual directories

​What is the CLI?

​Install

​Connect

​Start managing

​Common command groups

​Multilingual directories

What is the CLI?

Install

Connect

Start managing

Common command groups

Multilingual directories