Skip to main content
plugin CX Codex

darkmoon — Claude Code plugin: what it does, how to install

An MCP server for your own Darkmoon Pro instance: launch an authorized pentest run, then check its status, campaigns and findings from the agent.

GPL-3.0-only ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install darkmoon@awesome-codex-plugins
Open on GitHub

What darkmoon does

The plugin runs an MCP server, @darkmoon_ai/mcp-server, that connects your coding agent to a Darkmoon Pro dashboard. Four tools come with it. run_pentest kicks off an assessment of one target you are allowed to test and hands back a run_id; get_run_status reports where that run stands; list_campaigns and get_findings only read, listing campaigns and returning vulnerabilities with severity counts.

The server starts with npx -y @darkmoon_ai/mcp-server. The dashboard has to be your own: Darkmoon's engine and CLI are open source, but this server talks to the Pro Dashboard API, which ships self-hosted and has no public endpoint — so DARKMOON_BASE_URL points at your instance. Authentication takes either DARKMOON_USERNAME plus DARKMOON_PASSWORD or a pre-issued DARKMOON_TOKEN; each call requests a fresh JWT instead of reusing a cached one. DARKMOON_TIMEOUT_MS overrides the 60000 ms request timeout.

run_pentest changes state, so aim it at systems you own or have written permission to test. Findings can be wrong, and a person has to review them.

What it helps with

  • start a scan of a test environment and get the run_id
  • find out whether a run finished or errored out
  • browse dashboard campaigns without leaving the chat
  • pull a campaign's vulnerabilities grouped by severity
  • review findings before opening the dashboard yourself

Example prompts for the agent

  • Start a pentest on staging.example.com with run_pentest and give me the run_id.
  • Check whether the last run finished cleanly or hit an error.
  • List the campaigns and show findings for the newest one.

How to install darkmoon

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install darkmoon@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about darkmoon

How do I install darkmoon in Claude Code?

Through the marketplace: first /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install darkmoon@awesome-codex-plugins. Afterwards set DARKMOON_BASE_URL and your dashboard credentials.

What does darkmoon do?

It gives the agent four tools that talk to a Darkmoon Pro dashboard: start a run against a target, read run status, list campaigns, fetch campaign findings.

Does it work with the open source Darkmoon CLI alone?

No. The server calls the Dashboard API, which belongs to Darkmoon Pro and runs on your own infrastructure. Without your own instance there is no endpoint to reach.

Similar plugins

All plugins for Security →

From the same set391

The whole set →
dex The dex plugin for Claude Code and Codex explores data warehouses, maintains dbt models, and tracks schema drift. CX Codex ★ 1,596repo stars design-os-3d-blender design-os-3d-blender is a Claude Code plugin that creates parametric mechanical parts in Blender and checks geometry before export. CX Codex ★ 1,596repo stars deed-page deed-page deploys HTML files and static folders to permanent public URLs directly from your agent without any account or API key. CX Codex ★ 1,596repo stars dataproduct-builder-dbt dataproduct-builder-dbt — a plugin for Claude Code and Codex that covers the full dbt data-product lifecycle: scaffold, implement models from a data contract, audit live data, and sync metadata to Entropy Data. CX Codex ★ 1,596repo stars damnpdfs Connects 71 tools for PDFs, Office documents and images through a paired DamnPDFs browser tab. CX Codex ★ 1,596repo stars court-rules court-rules is a Claude Code and Codex plugin that searches US federal and state filing rules, judges’ standing orders, and court holidays. Results cite the court’s own documents. CX Codex ★ 1,596repo stars coolify This plugin connects Claude Code to Coolify Cloud or a self-hosted Coolify instance, letting the agent manage applications, view deployment history, check logs, and control environment variables through the Coolify API. CX Codex ★ 1,596repo stars context-pack context-pack generates a compact first-pass repository briefing for coding agents. It saves initial tool calls when exploring unfamiliar codebases. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open