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.
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 (
npm install -g @anthropic-ai/claude-codeor via the desktop app) - A nullplatform API key with Admin or Ops role at the organization level
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, the following slash commands become available inside any Claude Code session:
| Command | What it does |
|---|---|
/np-governance | Create and manage action items, categories, and AI suggestions |
/np-developer | Query APIs, manage deployments, operate scopes, and diagnose issues |
/np-troubleshooting | Investigate and diagnose platform entities in depth |
/np-service-craft | Design service specs, write workflows, and register services |
/np-setup-organization | Set up a new nullplatform organization end to end |
The full list of available plugins and their documentation is in the nullplatform AI plugins repository.
💡 Other supported assistants: The same plugins also work with Factory AI and Codex CLI.
2. Configure your API key​
Export your API key so the plugin can authenticate:
export NULLPLATFORM_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. Run your first prompt​
Start a Claude Code session and type:
/np-governance list my open action items
The plugin lists all open action items in your organization, grouped by priority. An empty list is a valid response: it means no action items exist yet.
✅ Checkpoint​
If you get a list (or an empty list), the plugin is working. If you see an authentication error, double-check the NULLPLATFORM_API_KEY variable.
What you can do next​
Now that the plugins are running, try these follow-up tutorials:
- Detect stale applications with AI: find apps that haven't been deployed in over 90 days and create action items automatically, with deduplication
- Track a runtime migration with Governance and Insights: use
np-governanceto flag all affected services and the Insights AI Builder to track the migration end to end
For a broader view of what action items are and how they fit into the platform, see Action items.