Skip to content

Repello-AI/artemis-recon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Artemis Recon — a Claude Code plugin

Connects Claude Code to the hosted Artemis Recon MCP server, which walks you through an authorized red-team reconnaissance engagement against an AI asset (chatbot, agent, RAG feature, LLM-powered endpoint):

scope → profile → surface → trust-map → synthesize → handoff

scope is a strict rules-of-engagement gate; the rest is authorized reconnaissance and bounded probing of the AI assets you scope in.

The server holds the playbook, the per-tenant state, the LLM reasoning loop, and the authorization document. This plugin ships only the slash commands, the mentor-mode skill, and the manifest that points at the hosted server.

Install

The plugin bundles the hosted mentor MCP server and provisions it with your API key, so install is one step. Two equivalent ways to provide the key:

Terminal:

claude plugin marketplace add Repello-AI/artemis-recon && \
claude plugin install artemis-recon@repelloai --config artemis_recon_api_key=YOUR_KEY

Desktop app: /pluginsMarketplaces → add Repello-AI/artemis-reconPluginsArtemis ReconInstall, and paste your key when prompted.

Replace YOUR_KEY with the rpl_… key from your dashboard (see "Get a key" below). The key is stored in your OS keychain and sent as a Bearer token to https://recon.repello.ai/mcp.

Then fully restart Claude Code — MCP tools load at session startup, so the mentor tools appear after a reopen. /plugin list should show artemis-recon@repelloai; /mcp should show mentor connected.

Prefer a standalone server instead of the bundled one? Skip --config and run claude mcp add mentor https://recon.repello.ai/mcp -t http -s user -H "Authorization: Bearer YOUR_KEY". The /recon skill works with either — it finds the mentor_* tools whatever the prefix.

Use

/recon notion.so

Artemis Recon will demand scope confirmation first (authorization basis, in-scope/out-of-scope assets, environment, allowed techniques, rate limits, stop conditions, etc.), then walk you through the recon phases. It only operates inside the scope you record — anything outside it is refused.

Slash commands

name what it does
/recon <target> start a fresh recon engagement
/reset [new objective] clear or resume an engagement

What's in this plugin

artemis-recon/
├── .claude-plugin/
│   ├── plugin.json              userConfig key + bundled mentor MCP (type:http, Bearer auth)
│   └── marketplace.json
├── commands/
│   ├── recon.md                 /recon
│   └── reset.md                 /reset
├── skills/
│   └── mentor-mode/
│       └── SKILL.md             the obedience contract
├── README.md
├── USAGE.md
└── LICENSE

No Go code, no binary, no playbook. All compute lives server-side.

Get a key

Sign in to the Artemis Recon dashboard at https://recon.repello.ai with your work email (magic link), then API keys → Create key. The key starts with rpl_ and is shown only once — paste it when the plugin prompts for the Artemis Recon API key (or pass --config artemis_recon_api_key=…). Rotate or revoke keys anytime from the same page; revoking immediately cuts off any client using that key.

License

Apache License 2.0 — see LICENSE.

About

Claude Code plugin for threat modelling connects Claude to the hosted Artemis Recon server and streams findings to a dashboard.

Resources

License

Stars

3 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors