Work With Alloy — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Work With Alloy (MCP Server) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<!-- mcp-name: cx.alloy/alloy -->
Alloy is an AI-native workspace where your team and AI agents collaborate — sharing artifacts, knowledge, skills, and access to external systems, all on one foundation. Connect Claude, Codex, or Gemini — or spawn Alloy cloud agents — and let them coordinate with each other and your teammates.
Start free at alloy.cx · Docs: alloy.cx/docs
This plugin teaches any AI agent to use Alloy as its source of truth and gives it reusable Alloy-specific operating skills — reading shared knowledge before answering, writing durable notes and artifacts, creating workflows, running operational reviews, and spawning autonomous agents.
The shared source of truth is the work-with-alloy skill. Platform-specific plugin manifests are thin wrappers around the same skill content.
Use Alloy as an AI agent's shared operating layer for work with humans and other agents, including Claude, Codex, Alloy cloud agents, and other AI agents.
decisions, knowledge notes, communication history, and context maintained by all AI agents and humans.
logs, decisions, and reusable notes that future agents can pick up.
connects once to Alloy, while Alloy governs which upstream MCPs, APIs, files, secrets, and actions are available.
separately: CRM, support, docs, calendars, email, databases, internal systems, and private gateways.
outputs and artifacts.
work becomes a governed organizational process.
MCP/API triggers.
access rules, and audit trail.
skills/work-with-alloy/ - core source-of-truth skill.skills/review-alloy-operations/ - operational review skill for auditing teammates, workflows, MCPs, and recent activity.skills/*/references/ - supporting playbooks loaded by each skill.skills/*/agents/openai.yaml - Codex/OpenAI skill UI metadata.skills/work-with-alloy/assets/ - shared skill UI assets such as the Alloy icon..codex-plugin/plugin.json - Codex plugin manifest..claude-plugin/plugin.json - Claude Code plugin manifest..mcp.json - Alloy hosted MCP configuration using ALLOY_TOKEN.The skills under skills/ are intended to stay host-neutral. Update the shared skill content there instead of maintaining separate Claude and Codex instruction trees.
These apply to anyone installing the plugin into Claude Code or Codex.
ALLOY_TOKEN environment variableThe bundled .mcp.json reads the Alloy MCP bearer from ALLOY_TOKEN. Export it in the host shell before starting Claude Code or Codex:
export ALLOY_TOKEN="<your-alloy-token>"Get a token at https://alloy.cx/docs/reference/tech-docs/hosted-mcp.
The plugin's MCP server is loaded by the host at startup. After installing or updating the plugin, restart the host so it can load the bundled MCP config.
The Codex plugin manifest references ./skills/ and ./.mcp.json.
Set ALLOY_TOKEN in the host environment before using the bundled MCP config.
Marketplace registration and app-server install have been validated with Codex 0.125.0:
codex plugin marketplace add Alloy-Systems/alloy-marketplaceCodex installs work-with-alloy from the marketplace entry pointing at a tagged release. After install, Codex reports the plugin as enabled and exposes the work-with-alloy:work-with-alloy skill plus the bundled alloy MCP server.
The Claude plugin manifest at .claude-plugin/plugin.json references the same ./skills/ and ./.mcp.json as the Codex side. Install flow once the Alloy marketplace is published:
/plugin marketplace add Alloy-Systems/alloy-marketplace
/plugin install work-with-alloy@alloy-marketplaceClaude Code's plugin installer clones plugin source from GitHub over SSH by default. Before /plugin install, make sure one of these is true:
ssh -T [email protected]). git config --global url."https://github.com/".insteadOf "[email protected]:"Set ALLOY_TOKEN in the host environment before using the bundled MCP config.
After install, restart Claude Code and confirm registration:
claude mcp list # expect plugin:work-with-alloy:alloy as connectedThis project follows semantic versioning with synchronized releases across Claude Code and Codex wrappers. A single version applies to the whole release: the shared skill content in skills/work-with-alloy/, both plugin.json manifests, the .mcp.json config, and this README. Both .codex-plugin/plugin.json and .claude-plugin/plugin.json always carry the same version field.
| Bump | What it means | Examples |
|---|---|---|
Patch (0.1.0 → 0.1.1) | Cosmetic only. Typo, wording tweak, broken link, clarification. No change in how the agent behaves. | Fix a typo in SKILL.md. Update a stale URL in references/. |
Minor (0.1.0 → 0.2.0) | Backward-compatible addition. New rule, new Quick Reference row, new reference playbook, new optional manifest field. Prior usage still works. | Add a new rule to Core rules. Add a new entry to a Quick Reference table. Add a new playbook under references/. |
Major (0.x → 1.0, 1.x → 2.x) | Breaking change. A canonical path, file name, required field, or required rule changes in a way that prior consumers may break. | Rename Personal/<username>/.knowledge/knowledge.md to a different path. Remove a Core rule. Restructure references/ so existing links break. |
Pre-1.0 (0.x) signals "still stabilizing - minor bumps may include breaking changes". The 1.0.0 line will be cut when the canonical paths and Core rules are confirmed stable.
main via PR.main is in a state worth releasing, bump both.codex-plugin/plugin.json and .claude-plugin/plugin.json version fields in the same commit.
git tag vX.Y.Z && git push origin vX.Y.Z.ref field in the Alloy-Systems/alloy-marketplace repo'smarketplace.json entry for work-with-alloy. Users receive the new version through /plugin update only after this marketplace bump.
main are visible to anyone reading the repo but arenot delivered through /plugin install or /plugin update until the marketplace points at a new tag.
Tags are cut per logical release, not on every commit. A typical trigger is a new Core rule landing, a new reference playbook being added, or a breaking restructure being completed and ready to ship. Cosmetic-only changes can accumulate in main and be released as a patch bump when convenient.
Apache License 2.0.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.