{
  "markdown": "# Almanax Security for Claude Code and Codex\n\nUse Almanax with Claude Code or Codex through the hosted MCP server at `https://mcp.almanax.ai`.\n\n## Claude Code\n\nSet your Almanax API key before starting Claude Code:\n\n```bash\nexport ALMANAX_API_KEY=\"your_api_key_here\"\n```\n\nThen install the marketplace and plugin:\n\n```bash\nclaude plugin marketplace add almanax-ai/almanax-security-plugin\nclaude plugin install almanax-security@almanax\n```\n\nRestart Claude Code after installation.\n\nBefore running your first scan, make sure the repository is available in Almanax. If needed, connect GitHub and link the repository in Almanax first.\n\nThen try:\n\n- `/almanax-security:setup`\n- `/almanax-security:scan-commit`\n\n## Codex\n\nCodex uses MCP configuration plus skills.\n\nSet your Almanax API key:\n\n```bash\nexport ALMANAX_API_KEY=\"your_api_key_here\"\n```\n\nConnect the hosted Almanax MCP server:\n\n```bash\ncodex mcp add --url https://mcp.almanax.ai --bearer-token-env-var ALMANAX_API_KEY almanax\ncodex mcp list\n```\n\nThen install one or both skills:\n\n```text\n$skill-installer install https://github.com/almanax-ai/almanax-security-plugin/tree/main/.agents/skills/almanax-setup\n$skill-installer install https://github.com/almanax-ai/almanax-security-plugin/tree/main/.agents/skills/almanax-scan-commit\n```\n\nIf you prefer file-based Codex configuration, merge the example in `.agents/skills/almanax-setup/codex-config.example.toml` into either `~/.codex/config.toml` or a project-scoped `.codex/config.toml`.\n\nBefore running your first scan, make sure the repository is available in Almanax. If needed, connect GitHub and link the repository in Almanax first.\n\nAfter setup, try prompts like:\n\n- `Use Almanax to get my recent security findings`\n- `Scan the current commit with Almanax and summarize the findings`\n\n## Getting an API Key\n\n1. Sign in to `https://app.almanax.ai`.\n2. Open your organization settings.\n3. Go to `Account` and create an API key in `API keys`.\n\n## Privacy and Terms\n\nUsing the hosted Almanax MCP server sends the information needed to fulfill your request to Almanax, which can include repository identifiers and commit diffs for scan workflows.\n\n- Privacy: `https://www.almanax.ai/privacy`\n- Terms: `https://www.almanax.ai/terms`\n\n## Troubleshooting\n\n- If authentication fails, verify that `ALMANAX_API_KEY` is set in the shell that launched Claude Code or Codex.\n- If a scan says the repository is unavailable, connect GitHub or link the repository in Almanax first.\n\nFor general product and integration documentation, see `https://docs.almanax.ai`.\n\n",
  "bytes": 2556,
  "sha": "a7ede159de39e4d294f48690470de75d2b5de8139440c7425174b74b1340e40f",
  "repo_slug": "almanax-ai/almanax-security-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_almanax_ai_almanax_security_plugin_alman_0973932d/readme"
}