Skip to main content

Set up the AI plugins

The nullplatform AI plugins let you operate nullplatform from your coding assistant (Claude Code, Kiro, Cursor, and others). You describe what you want in plain language and the plugin queries entities, paginates results, and calls the right API endpoints for you.

Every AI Ops feature starts from a plugin prompt, so set the plugins up once before following the rest of these docs.

info

The plugins are open source and maintained at github.com/nullplatform/ai-plugins. The repository is the source of truth for the full plugin catalog.

Before you start​

  • A coding assistant that supports plugins. The commands below use Claude Code; the same plugins also work with Kiro, Cursor, Factory AI, Codex CLI, and more
  • A nullplatform API key. The role it needs depends on what you plan to do: Developer covers day-to-day /np-developer operations like deployments and scope changes, while organization-level configuration (categories, checklists, workflows) needs Admin or Ops

1. Install the plugins​

Clone the plugin repository and install it:

git clone https://github.com/nullplatform/ai-plugins.git
cd ai-plugins
claude plugin install .

This installs the full nullplatform plugin suite. Once installed, slash commands like /np-governance (action items, workflows, checklists, and AI suggestions) and /np-developer (queries, deployments, scope operations, and diagnostics) become available inside any session. Browse the plugin catalog on GitHub for the complete, up-to-date list.

2. Configure your API key​

Export your API key so the plugins can authenticate:

export NP_API_KEY=<your_api_key_here>

Your API key needs access to the accounts and namespaces you want to operate on. See API keys to create one.

3. Verify the setup​

Start a session and type:

/np-developer show my latest deployments

The plugin queries your organization and lists the most recent deployments, with their application, scope, and status. An empty list is a valid response if nothing has been deployed yet.

If you get a list (or an empty list), the plugins are working. If you see an authentication error, check that NP_API_KEY is exported in the same shell where you started the session and that the key has access to the accounts you're querying.

Next steps​