Skip to main content

​
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

1

Get your API token

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

Authenticate

directify auth login YOUR_API_TOKEN
Your token is stored locally so you only do this once.
3

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

# 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

GroupCommands
authlogin, logout, status
configset-directory, get-directory
directorieslist
listingslist, get, create, update, delete, exists, bulk-create
categorieslist, get, create, update, delete
tagslist, get, create, update, delete
fieldslist, get, create, update, delete
organizerslist, get, create, update, delete
articleslist, get, create, update, delete, toggle
pageslist, get, create, update, delete, toggle
Run directify --help (or directify <group> --help) to see every command and option.
Want to manage your directory by chatting with an AI assistant instead? See the MCP Server guide.