---
title: Get started with nullplatform AI plugins
description: "🎯 Install the nullplatform AI plugins for Claude Code and run your first governance task using a natural-language prompt."
sidebar_label: AI plugins setup
toc_max_heading_level: 3
doc_id: 2a3e7f8c-1b4d-4e9a-8c2f-5d6a1b9e3f72
tutorial_type: tutorial
tutorial_category: ai
tutorial_order: 1
tutorial_time: 10 min
tutorial_featured: true
tutorial_cover: /img/tutorials/covers/ai-plugins-setup.svg
keywords:
  - Claude Code
  - AI plugins
  - np-governance
  - automation
  - natural language
  - nullplatform
tags:
  - ai
  - automation
  - governance
---

# 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](https://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](https://claude.ai/code) installed
- A [nullplatform API key](/docs/authorization/api-keys). The [role](/docs/authorization/roles) 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:

```bash
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](https://github.com/nullplatform/ai-plugins) 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:

```bash
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](/docs/authorization/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.

<video width="100%" autoPlay loop muted playsInline className="helper-image img-separator">
  <source src="/img/tutorials/plugin-setup/terminal-deployments.mp4" type="video/mp4" />
</video>

#### ✅ 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:

- [Detect stale applications with AI](/docs/tutorials/governance-detect-stale-apps): 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](/docs/tutorials/governance-track-migration): use `np-governance` to flag all affected services and the Insights AI Builder to track the migration end to end
<!-- - [Workflows](/docs/workflows/getting-started): describe a workflow in plain language, run it, and activate it -->

For a broader view of what action items are and how they fit into the platform, see [Action items](/docs/action-items/).

---

## Related docs

- [Action items](/docs/action-items)
- [API keys](/docs/authorization/api-keys)
- [Nullplatform AI plugins on GitHub](https://github.com/nullplatform/ai-plugins)
