Skip to content

Developer plugin

Airmsh for Codex and Claude Code.

Give your coding assistant the correct Airmsh workflows for private MCP, API, and database agents without copying service credentials into the conversation.

What is included

  • Codex plugin manifest
  • Claude Code plugin manifest
  • Airmsh agent skill
  • MCP, API, and database examples
  • Communication and access policy reference

Install

One download. Two coding assistants.

Extract the archive first. Airmsh must already be installed, signed in, and available as airmsh-cli.

Codex

codex plugin marketplace add /path/to/airmsh-agent-plugin
codex plugin add airmsh@airmsh

Start a new task, then ask to configure or use an Airmsh agent. Explicit invocation: $airmsh-agents.

Claude Code

claude plugin marketplace add /path/to/airmsh-agent-plugin
claude plugin install airmsh@airmsh

Start a new session or run /reload-plugins. Explicit invocation: /airmsh:airmsh-agents.

For a one-session Claude Code test, ask for the plugin-only archive in Discord, extract it, and run claude --plugin-dir /path/to/airmsh-agent-plugin.

Agent setup

Inspect, add, update, authenticate, pin, and remove destination-local agent definitions.

MCP and APIs

Prepare tools/list, tools/call, and normal HTTP request payloads without exposing bearer or API-key secrets.

Databases

Use MongoDB, Redis, MySQL, PostgreSQL, Neon, and SQLite/FileDB through their existing Airmsh adapters.

Policy-aware

Explain the per-agent access decision, request limits, schema pinning, sensitive-data handling, and signed audit path.

Communication

The plugin guides. Airmsh authenticates and carries the request.

The plugin is skills-first. It uses the installed Airmsh workflow and never creates an unprotected shortcut to a local service.

01

Coding assistant

Codex or Claude Code selects the Airmsh workflow and prepares the requested operation.

02

Local Airmsh

The installed app, CLI, or SDK supplies the signed-in user and device identity.

03

Encrypted connection

Airmsh reaches the named device over LAN when available or securely via the internet.

04

Destination gateway

The receiving device verifies identity, target device, agent tag, action, policy, limits, and pin.

05

Local service

Only then does the destination use its local credential and call the loopback MCP/API or native database adapter.

Airmsh checks the approved device and agent before each request. Passwords and service tokens stay on the destination device and are not shared with the coding assistant.

Sample requests

The plugin includes validated payload shapes for each adapter and points the assistant to the right one.

MongoDB     {"command":{"ping":1}}
Redis       {"args":["PING"]}
MySQL       {"query":"SELECT 1 AS ok"}
PostgreSQL  {"query":"SELECT current_database()"}
SQLite      {"query":"SELECT name FROM sqlite_master LIMIT 10"}
MCP         {"method":"tools/list","params":{}}
HTTP API    {"method":"GET","path":"/users","query":{"limit":10}}