FAQ

Does Nifty have an official CLI?

Not from Nifty itself. niftycli is an independent, open-source command-line tool — it isn't built or maintained by Nifty (niftypm.com). It works by using a feature Nifty already provides: every Nifty project can accept new tasks over email, at a per-project forwarding address. niftycli just automates sending that email from your terminal.

Can I create Nifty tasks without opening a browser?

Yes — that's the whole point of niftycli. Once you've configured your SMTP account and at least one project's forwarding email (niftycli init), running niftycli new creates a task entirely from the terminal, interactively or with flags for full automation. See Commands for the non-interactive flags.

How does niftycli actually create the task in Nifty?

It sends a plain email — task name as the subject, description as the body — to your Nifty project's forwarding address via your own SMTP account. Nifty receives that email and turns it into a task the same way it would if you'd forwarded it manually. niftycli never talks to a Nifty API or requires a Nifty API key.

Does niftycli work with Gmail, Outlook, or a custom SMTP server?

Any SMTP server works, as long as you can supply a host, port, username, and password (or app password). Gmail and Microsoft 365 both work but require an app password rather than your normal login — see Troubleshooting if the connection fails.

Can I manage multiple Nifty projects with niftycli?

Yes. niftycli project add/list/edit/remove manages any number of saved projects, each with its own forwarding email. Pass -p "<project name>" to niftycli new to target one directly, or leave it out to be prompted. See Project Management.

Is my SMTP password stored securely?

Your config, including the SMTP password, is stored locally at ~/.niftycli/config.json with file permissions restricted to your user only (0600). It is never sent anywhere except to your own configured SMTP server.

Can I automate Nifty task creation from scripts or CI?

Yes — niftycli new -p "<project>" -n "<task name>" -d "<description>" -s "<status>" runs non-interactively when all flags are supplied, so it can be called from shell scripts, cron jobs, or CI pipelines to create Nifty tasks automatically.

What happens if I accidentally send the same task twice?

Nifty silently ignores duplicate tasks on its end, so a retried or double-sent email won't create two tasks in your project.

Is niftycli free and open source?

Yes — niftycli is free, open source on GitHub under the ISC license, and published on npm.