SPB Git

Repository Public MIT

install-codex.md 2.2 KB 68 lines markdown

1---2title: Install in OpenAI Codex3description: Skill directories and MCP configuration for the Codex CLI.4order: 115section: Install6---78# Install in OpenAI Codex910Based on the Codex documentation as checked on 2026-11-09. Codex skills build on the same open Agent Skills format.1112## Skills1314| Scope | Location |15|---|---|16| User | `~/.agents/skills/<slug>/SKILL.md` |17| Repository | `.agents/skills/<slug>/SKILL.md` (in the working directory or any parent up to the repository root) |1819```bash20skills install @<namespace>/<slug> --client codex              # user scope21skills install @<namespace>/<slug> --client codex --project    # repository scope22```2324By hand:2526```bash27V=1.2.0; S=<slug>; N=<namespace>28curl -fsSLo $S-$V.tar.gz https://skills.spboucher.ai/api/v1/artifacts/$N/$S/versions/$V/download29curl -fsS https://skills.spboucher.ai/api/v1/artifacts/$N/$S/versions/$V/checksum | shasum -a 256 -c -30mkdir -p ~/.agents/skills/$S && tar -xzf $S-$V.tar.gz -C ~/.agents/skills/$S31```3233We could not confirm whether the older `~/.codex/skills` location is still read, so the registry does not install there.3435A skill written for Claude Code may use frontmatter fields that are not part of the open specification. The release page lists them as a finding (`skill-nonstandard-fields`); Codex may ignore them.3637## MCP servers3839Codex reads MCP servers from `~/.codex/config.toml` (or `.codex/config.toml` in a trusted project). The artifact page generates the block for you.4041Local server (stdio):4243```toml44[mcp_servers.<name>]45command = "<command>"46args = ["…"]47env_vars = ["API_KEY"]     # forwarded from your shell environment48```4950Remote server (Streamable HTTP):5152```toml53[mcp_servers.<name>]54url = "https://example.org/mcp"55bearer_token_env_var = "THEIR_TOKEN"   # optional: name of an env var holding the token56```5758For a stdio server you can also use `codex mcp add <name> --env VAR=VALUE -- <command>`. We show the TOML block for remote servers because we could not confirm the CLI flags for them.5960## The registry's own MCP server6162```toml63[mcp_servers.skills-registry]64url = "https://skills.spboucher.ai/mcp"65```6667Add `bearer_token_env_var = "SKILLS_TOKEN"` only if you want the publishing tools. See [MCP reference](/docs/mcp).68
Files main
Menu

Theme