AgentsMD v8.7.0
Align agent work with mission and Project Direction, then shape, deliver, and prove valuable outcomes through owned workflows.
v8.7.04ffe78481f94a3b61416a2583ef04d21928c6aa5b49b8744cc568b0fbb282925d3ca5884d598bb722351223467d162cef7ea21fbv1.3.1@076007789a4b3c1ff75c085a0e5b1d169f05cbafInstall with Codex
codex plugin marketplace add toolboxmd/marketplace
codex plugin add agentsmd@toolboxmd
Read the exact release documentation for host configuration, migration boundaries, and post-install steps.
OpenCode CLI
AgentsMD supports the OpenCode 1.18.29 CLI interface on POSIX hosts. The adapter checks that exact version and its required flags before a model run. Other versions need compatibility proof before this support claim expands. Provider availability is independent of host support; select an exact provider/model for each run. No model becomes a global default.
This CLI integration is separate from native plugin distribution for Codex, Claude Code, Grok. Read the exact released OpenCode guide.
Released setup, shared Skills and host limits
OpenCode composes project AGENTS.md found while walking up from its working directory with global $XDG_CONFIG_HOME/opencode/AGENTS.md, defaulting to ~/.config/opencode/AGENTS.md. CLAUDE.md is a project fallback, and ~/.claude/CLAUDE.md is a global fallback when the OpenCode global file is absent. Configured instructions add further sources. AgentsMD does not edit that configuration. See the official instruction rules.
OpenCode discovers ~/.agents/skills/<name>/SKILL.md and loads Skills on demand. Reuse that shared installation; this integration creates no Skill tree. Verify available names with opencode debug skill in the intended repository. The host also discovers project Skills and its own config Skill paths; avoid installing a second copy of a shared Skill there. See official Skill discovery. Host-native frontmatter differs: OpenCode ignores unrecognized fields, so user-only planning invocation continues to depend on the canonical operating contract.
The global contract requires the full Project Direction triad before project work. OpenCode does not run the Codex Project Direction lifecycle hook. A fresh session must read those files and applicable project instructions. The bounded adapter includes this obligation in its handoff prompt.
Use AGENTSMD_DIR for an extracted released artifact or stable canonical checkout of a released tag. The source must be a regular AGENTS.md outside plugin caches. Release identity is verified through the distribution workflow; the link command verifies path ownership and bytes, not GitHub release status.
"$AGENTSMD_DIR/bin/agentsmd-opencode" install --source "$AGENTSMD_DIR/AGENTS.md"
"$AGENTSMD_DIR/bin/agentsmd-opencode" status --source "$AGENTSMD_DIR/AGENTS.md"
"$AGENTSMD_DIR/bin/agentsmd-opencode" update --source "$AGENTSMD_DIR/AGENTS.md"
OpenCode does not reproduce Codex app-native task coordination, memory, connectors, computer/browser UI tools or lifecycle hooks. Host-native tools and permissions remain OpenCode's responsibility; AgentsMD supplies the shared operating contract and the narrow CLI handoff.
Active Skills (14)
algorithmApply the fixed five-step Algorithm to material requirements, solution design, process design, and recurring-loop automation. Use before material implementation, acceleration, or automation; keep small direct microfixes direct.delivery-profileLoad and validate a Project's `.toolboxmd/delivery.json` when it exists, or when delivery commands, artifact promotion, website impact, or Delivery System configuration are being decided. Use after Project Direction is loaded and before relying on Project-specific delivery behavior.domain-modelingBuild and sharpen project language. Use when agreeing terminology, writing or editing GLOSSARY.md or GLOSSARY-MAP.md, or recording a costly architectural decision.grill-with-docsRelentlessly sharpen a plan while recording resolved project terms and durable architectural decisions lazily.grillingGrill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.project-directionEstablish or repair repository Project Direction. Use when VISION.md, MISSION.md, or OBJECTIVE.md is missing, blank, unreadable, oversized, has unresolved placeholders, materially contradicts another direction file, or appears stale, reduces Vision to current work, leaves Mission without a present strategy, or merely restates one task, Issue, commit, or PR; when the Objective is achieved, invalidated, abandoned, or reprioritized; when the loader reports uninitialized or `potentially_stale` direction; or when the user asks to define, review, or update Project Direction. Do not invoke merely to reread an existing coherent triad.prototypeBuild a throwaway prototype to answer a concrete logic, state-model, behavior, or UI design question, including a Wayfinder Prototype Decision Issue.researchResolve a precise question from high-trust primary sources and capture cited findings for its owning GitHub Issue, including a Wayfinder Research Decision Issue.to-specRun the complete Specify workflow through an approved parent Issue and verified implementation ticket publication.to-ticketsBreak an approved plan or parent Issue into linked implementation Issues with explicit proof and native relationships.use-grokDelegate to the local Grok Build CLI when the user explicitly asks to ask, send, pass, delegate to, or consult Grok for research, coding, implementation, review, or a second opinion. Do not use unless the user asked to consult Grok.version-controlUse whenever a task may change tracked files in a Git repository, including code, documentation, AGENTS.md, skills, plugins, prompts, configuration, schemas, tests, or data. Run before the final commit or handoff so every completed deliverable has one reviewable SemVer transition. Also use for an explicitly requested WIP checkpoint. Do not use for strictly read-only audits, diagnoses, explanations, reviews, or status checks.wayfinderMap persistent decision fog as a parent GitHub Issue and a visible frontier of Decision Issues, then resolve one decision at a time until a reliable spec is possible.writing-for-agentsWriting documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
Released sources
Discovery compatibility
The well-known index is generated for the Vercel skills CLI and the Cloudflare discovery RFC v0.2.0. toolbox.md does not describe that distribution URL as part of the core Agent Skills file-format specification.