How do I install the Paxm Setup skill?

Run npx skillmds@latest add pax-beehive/paxm-setup-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Paxm Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Paxm Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Paxm Setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Paxm Setup?

pax-beehive (@pax-beehive) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Paxm Setup by pax-beehive — Agent Skill

Name: Paxm Setup
Rating: 4.2 (5 reviews)
Author: pax-beehive

File contents

Set up paxm for Codex

Run this workflow only when the user asks to configure, repair, or verify paxm. Do not silently install a binary, write provider credentials, or modify Codex hooks.

1. Diagnose first

Run the read-only checks:

paxm version
paxm config doctor --json

If paxm is not on PATH, check the standard user install locations before offering installation. Explain that the installer downloads the latest release binary by default and ask for explicit approval before running:

curl -fsSL https://github.com/pax-beehive/paxm/releases/latest/download/install.sh | bash

When a reproducible install or rollback is required, export a compatible release before running the command:

export PAXM_VERSION=v0.1.20
curl -fsSL https://github.com/pax-beehive/paxm/releases/latest/download/install.sh | bash

After installation, run paxm version again and report the resolved path. The equivalent bundled helper is scripts/install-paxm.sh when the plugin's absolute install path is available; do not assume PLUGIN_ROOT exists in a skill shell environment.

2. Configure the plugin-owned integration

Ask the user to choose providers and passive behavior, then run the interactive setup with Codex plugin ownership:

paxm setup --integration codex-plugin

The equivalent bundled helper is scripts/setup-paxm.sh when its absolute plugin path is available. This keeps provider credentials and profiles in paxm while preventing paxm from registering a duplicate global Codex hook. The plugin's own hook definitions remain subject to Codex's normal /hooks review and trust flow.

3. Verify the loop

After setup:

Run paxm config doctor.
Write one random test fact to STM and immediately recall it.
Explain which provider answered and that the test fact will expire.
Ask the user to start a fresh Codex task or submit one prompt so the passive hook can be observed.
Use paxm history --days 1 to confirm the hook event.

If a check fails, identify the layer (plugin, binary, config, provider, hook trust, or Codex task lifecycle) and give one next action. Do not reinstall everything by default.

Safety rules

Never print or echo provider API keys.
Never modify ~/.codex/config.toml from a setup script.
Never bypass Codex hook trust.
Hook failures must not block the user's Codex task.
Keep MCP optional until the binary and plugin-owned hook path are healthy.

---name: paxm-setup-2description: Guide a user through first-time paxm setup for the Codex memory plugin, including binary installation, provider configuration, hook trust, and a real smoke test.---# Set up paxm for CodexRun this workflow only when the user asks to configure, repair, or verify paxm.Do not silently install a binary, write provider credentials, or modify Codexhooks.## 1. Diagnose firstRun the read-only checks:```bashpaxm versionpaxm config doctor --json```If `paxm` is not on `PATH`, check the standard user install locations beforeoffering installation. Explain that the installer downloads the latest releasebinary by default and ask for explicit approval before running:```bashcurl -fsSL https://github.com/pax-beehive/paxm/releases/latest/download/install.sh | bash```When a reproducible install or rollback is required, export a compatiblerelease before running the command:```bashexport PAXM_VERSION=v0.1.20curl -fsSL https://github.com/pax-beehive/paxm/releases/latest/download/install.sh | bash```After installation, run `paxm version` again and report the resolved path.The equivalent bundled helper is `scripts/install-paxm.sh` when the plugin'sabsolute install path is available; do not assume `PLUGIN_ROOT` exists in askill shell environment.## 2. Configure the plugin-owned integrationAsk the user to choose providers and passive behavior, then run the interactivesetup with Codex plugin ownership:```bashpaxm setup --integration codex-plugin```The equivalent bundled helper is `scripts/setup-paxm.sh` when its absoluteplugin path is available. This keeps provider credentials and profiles in paxm while preventing paxm fromregistering a duplicate global Codex hook. The plugin's own hook definitionsremain subject to Codex's normal `/hooks` review and trust flow.## 3. Verify the loopAfter setup:1. Run `paxm config doctor`.2. Write one random test fact to STM and immediately recall it.3. Explain which provider answered and that the test fact will expire.4. Ask the user to start a fresh Codex task or submit one prompt so the passive hook can be observed.5. Use `paxm history --days 1` to confirm the hook event.If a check fails, identify the layer (plugin, binary, config, provider, hooktrust, or Codex task lifecycle) and give one next action. Do not reinstalleverything by default.## Safety rules- Never print or echo provider API keys.- Never modify `~/.codex/config.toml` from a setup script.- Never bypass Codex hook trust.- Hook failures must not block the user's Codex task.- Keep MCP optional until the binary and plugin-owned hook path are healthy.

Frequently asked questions

Paxm Setup