Can I use Nifty as a CLI?

Yes. KosmoKrator exposes a Nifty CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Nifty through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Nifty tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Nifty credentials stored?

Nifty credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Nifty MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Nifty CLI for Headless Automation

Use the Nifty CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

6 functions 5 read 1 write Bearer token auth

Submit Nifty feedback View package source

Nifty CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Nifty CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Nifty CLI for Headless Automation
kosmokrator integrations:configure nifty --set access_token="$NIFTY_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call nifty.nifty_list_projects '{"limit":1,"offset":1}' --json

Discovery Before Execution

Agents and scripts can inspect Nifty docs and schemas before choosing a function.

kosmo integrations:docs nifty --json
kosmo integrations:docs nifty.nifty_list_projects --json
kosmo integrations:schema nifty.nifty_list_projects --json
kosmo integrations:search "Nifty" --json
kosmo integrations:list --json

Useful Nifty CLI Functions

Function	Type	Parameters	Description
`nifty.nifty_list_projects`	Read	limit, offset	List all projects in Nifty. Returns project IDs, names, and metadata that can be used to query tasks.
`nifty.nifty_get_project`	Read	project_id	Get details of a specific Nifty project by its ID, including name, description, status, and task lists.
`nifty.nifty_list_tasks`	Read	project_id, status, assignee_id, milestone_id, task_list_id, limit, offset	List tasks in Nifty with optional filters. Filter by project, status, assignee, or other criteria. Returns task IDs, titles, statuses, and assignees.
`nifty.nifty_get_task`	Read	task_id	Get details of a specific Nifty task by its ID, including title, description, status, assignee, and due date.
`nifty.nifty_create_task`	Write	title, project_id, description, task_list_id, assignee_id, due_date, priority, labels	Create a new task in a Nifty project. Requires a title and project ID. Optionally include a description, task list, assignee, and due date.
`nifty.nifty_get_current_user`	Read	none	Get the profile of the currently authenticated Nifty user, including name, email, and workspace membership.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Nifty CLI Pages

CI Nifty CLI for CI. Cron Jobs Nifty CLI for cron jobs. Shell Scripts Nifty CLI for shell scripts. Coding Agents Nifty CLI for coding agents.