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 Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Nifty KosmoKrator integration.

6 functions 5 read 1 write Bearer token auth

Submit Nifty feedback View package source

Lua Namespace

Agents call this integration through app.integrations.nifty.*. Use lua_read_doc("integrations.nifty") inside KosmoKrator to discover the same reference at runtime.

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Nifty Integration

Tools

nifty_list_projects

List all projects in Nifty.

Parameters: limit (integer, optional), offset (integer, optional)

nifty_get_project

Get details of a specific project.

Parameters: project_id (string, required)

nifty_list_tasks

List tasks with optional filters.

Parameters: project_id (string, optional), status (string, optional), assignee_id (string, optional), milestone_id (string, optional), task_list_id (string, optional), limit (integer, optional), offset (integer, optional)

nifty_get_task

Get details of a specific task.

Parameters: task_id (string, required)

nifty_create_task

Create a new task in a project.

Parameters: title (string, required), project_id (string, required), description (string, optional), task_list_id (string, optional), assignee_id (string, optional), due_date (string, optional), priority (string, optional), labels (array, optional)

nifty_get_current_user

Get the authenticated user profile.

Parameters: none

Raw agent markdown

# Nifty Integration

## Tools

### nifty_list_projects
List all projects in Nifty.
- **Parameters:** `limit` (integer, optional), `offset` (integer, optional)

### nifty_get_project
Get details of a specific project.
- **Parameters:** `project_id` (string, required)

### nifty_list_tasks
List tasks with optional filters.
- **Parameters:** `project_id` (string, optional), `status` (string, optional), `assignee_id` (string, optional), `milestone_id` (string, optional), `task_list_id` (string, optional), `limit` (integer, optional), `offset` (integer, optional)

### nifty_get_task
Get details of a specific task.
- **Parameters:** `task_id` (string, required)

### nifty_create_task
Create a new task in a project.
- **Parameters:** `title` (string, required), `project_id` (string, required), `description` (string, optional), `task_list_id` (string, optional), `assignee_id` (string, optional), `due_date` (string, optional), `priority` (string, optional), `labels` (array, optional)

### nifty_get_current_user
Get the authenticated user profile.
- **Parameters:** none

Metadata-Derived Lua Example

local result = app.integrations.nifty.nifty_list_projects({
  limit = 1,
  offset = 1
})
print(result)

Functions

`nifty_list_projects`

List all projects in Nifty. Returns project IDs, names, and metadata that can be used to query tasks.

Operation: Read read
Full name: nifty.nifty_list_projects

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of projects to return.
`offset`	integer	no	Number of projects to skip for pagination.

`nifty_get_project`

Get details of a specific Nifty project by its ID, including name, description, status, and task lists.

Operation: Read read
Full name: nifty.nifty_get_project

Parameter	Type	Required	Description
`project_id`	string	yes	The ID of the project to retrieve.

`nifty_list_tasks`

List tasks in Nifty with optional filters. Filter by project, status, assignee, or other criteria. Returns task IDs, titles, statuses, and assignees.

Operation: Read read
Full name: nifty.nifty_list_tasks

Parameter	Type	Required	Description
`project_id`	string	no	Filter tasks by project ID.
`status`	string	no	Filter by task status (e.g., "open", "in_progress", "completed").
`assignee_id`	string	no	Filter by assignee user ID.
`milestone_id`	string	no	Filter by milestone ID.
`task_list_id`	string	no	Filter by task list ID.
`limit`	integer	no	Maximum number of tasks to return.
`offset`	integer	no	Number of tasks to skip for pagination.

`nifty_get_task`

Get details of a specific Nifty task by its ID, including title, description, status, assignee, and due date.

Operation: Read read
Full name: nifty.nifty_get_task

Parameter	Type	Required	Description
`task_id`	string	yes	The ID of the task to retrieve.

`nifty_create_task`

Create a new task in a Nifty project. Requires a title and project ID. Optionally include a description, task list, assignee, and due date.

Operation: Write write
Full name: nifty.nifty_create_task

Parameter	Type	Required	Description
`title`	string	yes	The title of the task.
`project_id`	string	yes	The ID of the project to create the task in.
`description`	string	no	A detailed description of the task (supports markdown).
`task_list_id`	string	no	The ID of the task list to add the task to.
`assignee_id`	string	no	The user ID of the person to assign the task to.
`due_date`	string	no	Due date for the task (ISO 8601 format, e.g., "2025-12-31").
`priority`	string	no	Task priority level (e.g., "low", "medium", "high", "urgent").
`labels`	array	no	Array of label names to apply to the task.

`nifty_get_current_user`

Get the profile of the currently authenticated Nifty user, including name, email, and workspace membership.

Operation: Read read
Full name: nifty.nifty_get_current_user

Parameter	Type	Required	Description
No parameters.