{
  "markdown": "<p align=\"center\">\n  <img src=\"docs/public/favicon.svg\" alt=\"redmine-cli logo\" width=\"120\" />\n</p>\n\n<h1 align=\"center\">redmine-cli</h1>\n\n<p align=\"center\">\n  A command-line interface for <a href=\"https://www.redmine.org/\">Redmine</a> project management.\n</p>\n\n<p align=\"center\">\n  <b>English</b> ·\n  <a href=\"README.zh-CN.md\">简体中文</a> ·\n  <a href=\"README.ja.md\">日本語</a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/aarondpn/redmine-cli/actions/workflows/ci.yml\"><img src=\"https://img.shields.io/github/actions/workflow/status/aarondpn/redmine-cli/ci.yml?style=for-the-badge&logo=githubactions&logoColor=white&label=CI\" alt=\"CI\"></a>\n  <a href=\"https://github.com/aarondpn/redmine-cli/releases/latest\"><img src=\"https://img.shields.io/github/v/release/aarondpn/redmine-cli?style=for-the-badge&logo=github&logoColor=white\" alt=\"Release\"></a>\n  <a href=\"https://go.dev/\"><img src=\"https://img.shields.io/github/go-mod/go-version/aarondpn/redmine-cli?style=for-the-badge&logo=go&logoColor=white\" alt=\"Go\"></a>\n  <a href=\"https://opensource.org/licenses/MIT\"><img src=\"https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge&logo=opensourceinitiative&logoColor=white\" alt=\"License\"></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.redmine.org/projects/redmine/wiki/changelog\"><img src=\"https://img.shields.io/badge/Redmine-4.x-B32024?style=for-the-badge&logo=redmine&logoColor=white\" alt=\"Redmine 4.x\"></a>\n  <a href=\"https://www.redmine.org/projects/redmine/wiki/changelog\"><img src=\"https://img.shields.io/badge/Redmine-5.x-B32024?style=for-the-badge&logo=redmine&logoColor=white\" alt=\"Redmine 5.x\"></a>\n  <a href=\"https://www.redmine.org/projects/redmine/wiki/changelog\"><img src=\"https://img.shields.io/badge/Redmine-6.x-B32024?style=for-the-badge&logo=redmine&logoColor=white\" alt=\"Redmine 6.x\"></a>\n  <a href=\"https://www.redmine.org/projects/redmine/wiki/changelog\"><img src=\"https://img.shields.io/badge/Redmine-7.x-B32024?style=for-the-badge&logo=redmine&logoColor=white\" alt=\"Redmine 7.x\"></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"#installation\">Installation</a> ·\n  <a href=\"#getting-started\">Getting Started</a> ·\n  <a href=\"#ai-agents\">AI Agents</a>\n</p>\n\n## Installation\n\n### Homebrew (macOS & Linux)\n\n```bash\nbrew tap aarondpn/tap\nbrew install redmine\n```\n\nThis also installs shell completions for bash, zsh, and fish.\n\n### Quick Install Script\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/aarondpn/redmine-cli/main/install.sh | bash\n```\n\nAuto-detects your OS and architecture, downloads the latest release with checksum verification, and installs to `~/.local/bin`.\n\n### Install with Go\n\n```bash\ngo install github.com/aarondpn/redmine-cli/v2/cmd/redmine@latest\n```\n\n### Manual Download\n\nGrab the latest release for your platform from [GitHub Releases](https://github.com/aarondpn/redmine-cli/releases/latest):\n\n| Platform      | Architecture | Download |\n|---------------|-------------|----------|\n| Linux         | x86_64      | `redmine-cli-linux-amd64.tar.gz` |\n| Linux         | ARM64       | `redmine-cli-linux-arm64.tar.gz` |\n| macOS         | Intel       | `redmine-cli-darwin-amd64.tar.gz` |\n| macOS         | Apple Silicon | `redmine-cli-darwin-arm64.tar.gz` |\n| Windows       | x86_64      | `redmine-cli-windows-amd64.zip` |\n\n### Updating\n\n```bash\nredmine update\n```\n\nDownloads and verifies the latest release via SHA256 checksum before replacing the binary.\n\n## Getting Started\n\n```bash\n# Configure your Redmine server and API key\nredmine auth login\n\n# List issues\nredmine issues list\n\n# View a specific issue\nredmine issues view 123\n\n# Log time\nredmine time log\n```\n\nRun `redmine --help` to see all available commands.\n\n<a name=\"ai-agents\"></a>\n\n## Using with AI Agents\n\nredmine-cli ships an [Agent Skill](https://agentskills.io) (the open `SKILL.md` standard, supported by 35+ agents) and a built-in MCP server. Both are vendor-neutral - pick the one-liner that matches your tool:\n\n| Tool | One-line install |\n|---|---|\n| **Any agent (skill)** | `npx skills add aarondpn/redmine-cli` |\n| **Any MCP host** | `redmine mcp serve` (then add to host config) |\n| **Claude Code** | `/plugin marketplace add aarondpn/redmine-cli` then `/plugin install redmine` |\n| **Codex CLI** | `codex plugin marketplace add aarondpn/redmine-cli` then `/plugins` (install **Redmine** from the added marketplace) |\n| **Gemini CLI** | `gemini extensions install https://github.com/aarondpn/redmine-cli` |\n\nThe skill teaches the agent the non-obvious parts of the CLI (output formats, name resolution, pagination, common workflows). The MCP server exposes the same operations as typed tool calls, read-only by default, with per-group / per-tool allow- and deny-lists.\n\nFull configuration, host-specific snippets (Claude Desktop, Cursor, Zed, VS Code), and write-tool gating: see the [AI Agent Integration guide](https://redmine-cli.dev/guides/ai-agents/).\n\n## Development\n\nLocal E2E testing against a real Redmine instance (Docker, supported on Redmine `4.2`, `5.1`, `6.1`, `7.0`): see [e2e/README.md](e2e/README.md).\n",
  "bytes": 5052,
  "sha": "1c5767386d859f016e359f759059864a1cf31afc8f2e15bb42aba9426b132061",
  "repo_slug": "aarondpn/redmine-cli",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_aarondpn_redmine_cli_83d47f25/readme"
}