{"id":36989937,"url":"https://github.com/redis-developer/redisctl","last_synced_at":"2026-03-18T00:18:22.612Z","repository":{"id":311813363,"uuid":"1045163390","full_name":"redis-developer/redisctl","owner":"redis-developer","description":"Unified CLI for Redis Cloud and Enterprise management","archived":false,"fork":false,"pushed_at":"2026-01-13T23:59:45.000Z","size":20312,"stargazers_count":8,"open_issues_count":18,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-14T00:00:01.280Z","etag":null,"topics":["cli","redis","redis-cloud","redis-enterprise"],"latest_commit_sha":null,"homepage":"https://redis-field-engineering.github.io/redisctl-docs/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/redis-developer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-26T18:41:45.000Z","updated_at":"2026-01-13T23:59:48.000Z","dependencies_parsed_at":"2025-08-27T02:41:42.790Z","dependency_job_id":"80556e28-8c12-4071-a60f-96af098c78fe","html_url":"https://github.com/redis-developer/redisctl","commit_stats":null,"previous_names":["joshrotenberg/redisctl","redis-developer/redisctl"],"tags_count":43,"template":false,"template_full_name":null,"purl":"pkg:github/redis-developer/redisctl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redis-developer%2Fredisctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redis-developer%2Fredisctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redis-developer%2Fredisctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redis-developer%2Fredisctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/redis-developer","download_url":"https://codeload.github.com/redis-developer/redisctl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/redis-developer%2Fredisctl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28534203,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","redis","redis-cloud","redis-enterprise"],"created_at":"2026-01-13T23:32:31.745Z","updated_at":"2026-03-18T00:18:22.598Z","avatar_url":"https://github.com/redis-developer.png","language":"Rust","readme":"# redisctl\n\n**Manage Redis Cloud, Redis Enterprise, and Redis databases from one tool** -- as a CLI for humans or an MCP server for AI agents.\n\n[![Crates.io](https://img.shields.io/crates/v/redisctl.svg)](https://crates.io/crates/redisctl)\n[![CI](https://github.com/redis-developer/redisctl/actions/workflows/ci.yml/badge.svg)](https://github.com/redis-developer/redisctl/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg)](https://github.com/redis-developer/redisctl#license)\n\nredisctl replaces curl-and-jq scripts against the Redis Cloud and Enterprise REST APIs with a single binary that handles authentication, async polling, output formatting, and error handling. The same tool ships as an MCP server so AI assistants can manage Redis infrastructure directly.\n\n---\n\n## Pick Your Path\n\n| I want to... | Start here |\n|---|---|\n| Manage **Redis Cloud** from my terminal | [CLI Quick Start](#quick-start) |\n| Manage **Redis Enterprise** from my terminal | [CLI Quick Start](#quick-start) |\n| Let an **AI assistant** manage Redis | [MCP Server](#mcp-server) |\n| Query or inspect a **Redis database** directly | [Database Tools](#database-tools) |\n\n---\n\n## Quick Start\n\n### Install\n\n```bash\n# Homebrew (macOS/Linux)\nbrew install redis-developer/homebrew-tap/redisctl\n\n# Cargo\ncargo install redisctl\n\n# Binary releases: https://github.com/redis-developer/redisctl/releases\n```\n\n### Configure a Profile\n\n```bash\n# Redis Cloud\nredisctl profile set prod \\\n  --deployment cloud \\\n  --api-key \"$REDIS_CLOUD_API_KEY\" \\\n  --api-secret \"$REDIS_CLOUD_SECRET_KEY\"\n\n# Redis Enterprise\nredisctl profile set dev \\\n  --deployment enterprise \\\n  --url \"https://cluster.local:9443\" \\\n  --username \"admin@redis.local\" \\\n  --password \"$REDIS_ENTERPRISE_PASSWORD\"\n```\n\n### Run Commands\n\n```bash\n# List databases (platform inferred from profile)\nredisctl database list\n\n# Create a database and wait for it to be ready\nredisctl database create @db-config.json --wait\n\n# Get cluster info as a table\nredisctl cluster get -o table\n\n# Filter output with JMESPath\nredisctl database list -q 'databases[?status==`active`].name'\n```\n\nThe `cloud`/`enterprise` prefix is optional -- the CLI infers the platform from your profile. Use explicit prefixes (`redisctl cloud database list`) in scripts or when you have profiles for both platforms.\n\n---\n\n## MCP Server\n\n`redisctl-mcp` exposes 300+ tools to AI assistants (Claude Desktop, Cursor, VS Code, or any MCP client). It covers the full Cloud and Enterprise APIs plus direct Redis database operations -- all with a safety-first policy system.\n\n### Set Up\n\n```json\n{\n  \"mcpServers\": {\n    \"redisctl\": {\n      \"command\": \"redisctl-mcp\",\n      \"args\": [\"--profile\", \"my-profile\"]\n    }\n  }\n}\n```\n\n**Read-only by default.** Write and destructive operations require explicit opt-in via a policy file (`redisctl-mcp.toml`):\n\n```toml\ntier = \"standard\"  # read-only (default) | standard (read-write) | full (destructive)\n```\n\n### Zero-Install with Docker\n\n`REDIS_ENTERPRISE_PASSWORD` is passed without a value so Docker forwards it from your host environment (keeps the secret out of the config file):\n\n```json\n{\n  \"mcpServers\": {\n    \"redisctl\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \"REDIS_ENTERPRISE_URL=https://cluster:9443\",\n        \"-e\", \"REDIS_ENTERPRISE_USER=admin@redis.local\",\n        \"-e\", \"REDIS_ENTERPRISE_PASSWORD\",\n        \"ghcr.io/redis-developer/redisctl\",\n        \"redisctl-mcp\"\n      ]\n    }\n  }\n}\n```\n\nSee the [MCP documentation](https://redis-field-engineering.github.io/redisctl-docs/mcp/) for client configuration guides, the full tool catalog, and safety policy reference.\n\n---\n\n## What's Covered\n\n### Redis Cloud -- Full API Coverage\n\nSubscriptions, databases, VPC peering, Transit Gateway, PrivateLink, Private Service Connect, ACLs, cloud accounts, tasks, and async operations.\n\n### Redis Enterprise -- Full API Coverage\n\nClusters, nodes, shards, databases (BDBs), Active-Active (CRDBs), users, roles, LDAP, logs, metrics, alerts, support packages, and diagnostics.\n\n### Database Tools\n\nConnect directly to any Redis instance for key inspection, data structure operations, server diagnostics, and health checks. Available in both the CLI and MCP server.\n\n### Key Capabilities\n\n- **Async operations** -- `--wait` automatically polls long-running operations to completion\n- **Output formats** -- tables, JSON, YAML, with JMESPath filtering (`-q`)\n- **Profiles** -- manage multiple environments with optional keyring-backed credential storage\n- **Workflows** -- high-level commands that compose multi-step operations (e.g., `subscription-setup`)\n- **Raw API access** -- `redisctl api cloud get /subscriptions/12345` for any endpoint\n- **Streaming** -- `--follow` for real-time log tailing\n\n---\n\n## Documentation\n\n**[Full Documentation](https://redis-field-engineering.github.io/redisctl-docs/)**\n\n- [Getting Started](https://redis-field-engineering.github.io/redisctl-docs/getting-started/)\n- [Configuration](https://redis-field-engineering.github.io/redisctl-docs/configuration/)\n- [MCP Server](https://redis-field-engineering.github.io/redisctl-docs/mcp/)\n- [Command Reference](https://redis-field-engineering.github.io/redisctl-docs/reference/)\n- [Workflows](https://redis-field-engineering.github.io/redisctl-docs/workflows/)\n\n---\n\n## Changelogs\n\n- [redisctl CLI](crates/redisctl/CHANGELOG.md)\n- [redisctl-core](crates/redisctl-core/CHANGELOG.md)\n- [redisctl-mcp](crates/redisctl-mcp/CHANGELOG.md)\n\nAPI client libraries (separate repositories):\n- [redis-cloud](https://github.com/redis-developer/redis-cloud-rs)\n- [redis-enterprise](https://github.com/redis-developer/redis-enterprise-rs)\n\n---\n\n## Contributing\n\n```bash\ngit clone https://github.com/redis-developer/redisctl.git\ncd redisctl\ncargo build --release\ncargo test --workspace\ncargo clippy --all-targets -- -D warnings\n```\n\nSee the [Contributing Guide](https://redis-field-engineering.github.io/redisctl-docs/developer/contributing.html).\n\n---\n\n## License\n\nLicensed under either of [Apache License 2.0](LICENSE-APACHE) or [MIT](LICENSE-MIT), at your option.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredis-developer%2Fredisctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredis-developer%2Fredisctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredis-developer%2Fredisctl/lists"}