Skip to main content

Get started with nullplatform AI plugins

🎯 Goal: Set up the nullplatform AI plugins so you can query, create, and manage platform entities through plain-language prompts instead of writing API calls or navigating the UI.

Introduction​

The nullplatform AI plugins bring platform operations into your terminal. Instead of navigating the UI or writing API calls, you describe what you want in plain language and the plugin handles the rest: querying entities, paginating results, deduplicating records, and calling the right API endpoints.

The plugins are the entry point for most AI-driven work on nullplatform. Governance sweeps, workflow authoring, and troubleshooting sessions all start from a plugin prompt, so setting them up once unlocks everything that builds on them.

note

These plugins are open source and maintained at github.com/nullplatform/ai-plugins. The repository is the source of truth for the full plugin catalog and per-plugin documentation, which evolve faster than this page.

This tutorial covers installation and a first prompt. Once the plugins are running, the other tutorials in this section show what you can build with them.

What you'll set up​

By the end of this guide, you'll have:

  • The nullplatform AI plugins installed in Claude Code
  • Your API key configured
  • A verified working prompt against your organization

Prerequisites​

  • Claude Code installed
  • 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 governance configuration (categories, approvals) needs Admin or Ops.

1. Install the nullplatform plugin​

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, categories, and AI suggestions) and /np-developer (queries, deployments, scope operations, and diagnostics) become available inside any Claude Code session. Browse the plugin catalog on GitHub for the complete, up-to-date list.

💡 Other supported assistants: The same plugins also work with Factory AI, Codex CLI, Kiro, and more.

2. Configure your API key​

Export your API key so the plugin 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 Claude Code 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.

✅ Checkpoint​

If you get a list (or an empty list), the plugins are working. If you see an authentication error, double-check the NP_API_KEY variable.

What you can do next​

Now that the plugins are running, try these follow-up tutorials:

For a broader view of what action items are and how they fit into the platform, see Action items.