{"id":16702363,"url":"https://github.com/axonops/axonops-workbench","last_synced_at":"2026-04-11T20:11:45.349Z","repository":{"id":247918633,"uuid":"766959309","full_name":"axonops/axonops-workbench","owner":"axonops","description":"AxonOps™ Workbench for Apache Cassandra® - Desktop application for Mac, Windows and Linux","archived":false,"fork":false,"pushed_at":"2025-04-04T11:18:45.000Z","size":44834,"stargazers_count":13,"open_issues_count":176,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-04T12:22:46.445Z","etag":null,"topics":["apache-cassandra","apache-cassandra-tools","axonops","cassandra","cassandra-cluster","cassandra-cql","cassandra-database","cassandra-driver","cql","cql-queries","cqlsh","database","database-admin","dba","desktop","desktop-app","desktop-application","desktop-apps","desktop-client","developer-tools"],"latest_commit_sha":null,"homepage":"https://axonops.com","language":"JavaScript","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/axonops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-04T13:00:37.000Z","updated_at":"2025-04-04T11:18:48.000Z","dependencies_parsed_at":"2024-11-11T17:26:48.137Z","dependency_job_id":"f301f861-230a-4c58-a364-62a11822ac2c","html_url":"https://github.com/axonops/axonops-workbench","commit_stats":{"total_commits":290,"total_committers":7,"mean_commits":41.42857142857143,"dds":0.7206896551724138,"last_synced_commit":"3923534ec82e3925f1c9c7d45e08432f2a930901"},"previous_names":["axonops/axonops-workbench-cassandra","axonops/axonops-workbench"],"tags_count":144,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axonops%2Faxonops-workbench","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axonops%2Faxonops-workbench/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axonops%2Faxonops-workbench/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axonops%2Faxonops-workbench/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/axonops","download_url":"https://codeload.github.com/axonops/axonops-workbench/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248158310,"owners_count":21057150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["apache-cassandra","apache-cassandra-tools","axonops","cassandra","cassandra-cluster","cassandra-cql","cassandra-database","cassandra-driver","cql","cql-queries","cqlsh","database","database-admin","dba","desktop","desktop-app","desktop-application","desktop-apps","desktop-client","developer-tools"],"created_at":"2024-10-12T19:03:06.751Z","updated_at":"2026-02-02T12:27:10.385Z","avatar_url":"https://github.com/axonops.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"renderer/assets/images/axonops-icon-512x512.png\" alt=\"AxonOps Workbench Icon\" width=\"128\"\u003e\n\n  # AxonOps Workbench\n\n  **Purpose-Built Database Management Desktop App for Apache Cassandra®**\n\n  [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n  [![GitHub Issues](https://img.shields.io/github/issues/axonops/axonops-workbench)](https://github.com/axonops/axonops-workbench/issues)\n  [![GitHub Discussions](https://img.shields.io/github/discussions/axonops/axonops-workbench)](https://github.com/axonops/axonops-workbench/discussions)\n  [![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)](https://axonops.com/workbench/download/)\n\n  [🚀 Download](https://axonops.com/workbench/download/) | [📚 Documentation](https://docs.axonops.com/) | [💬 Discussions](https://github.com/axonops/axonops-workbench/discussions/categories/ideas) | [🐛 Issues](https://github.com/axonops/axonops-workbench/issues/new/choose)\n\u003c/div\u003e\n\n## 🚀 Overview\n\n[AxonOps Workbench](https://axonops.com/workbench/) is a **powerful, free, and open-source** desktop application designed specifically for Cassandra developers and DBAs. Experience a revolutionary way to work with your distributed databases through an intuitive interface packed with advanced features.\n\n\u003cdiv align=\"center\"\u003e\n\n  ### 🎁 100% Free \u0026 Open Source\n  **No hidden costs • No premium tiers • No license keys**\n\n  Community-driven development with full transparency\n\n\u003c/div\u003e\n\n### 🔗 Supported Databases\n- **[Apache Cassandra®](https://cassandra.apache.org/)** - The leading open-source distributed database\n- **[DataStax™ Enterprise](https://www.datastax.com/products/datastax-enterprise)** - Enterprise-ready Cassandra distribution\n- **[DataStax™ Astra DB](https://www.datastax.com/products/datastax-astra)** - Serverless Cassandra-as-a-Service\n\n### ✨ Why AxonOps Workbench?\n\n- 🎯 **Cassandra-Native Design** - Engineered specifically for Cassandra's unique architecture and workflows\n- 🛠️ **Developer-Friendly** - Intuitive interface with powerful productivity features\n- 🔒 **Secure by Design** - Built-in SSH tunneling and credential management\n- 🏃 **Local Development** - Spin up local Cassandra clusters with one click\n- 📊 **Advanced Analytics** - Deep query tracing and performance insights\n- 🌍 **Cross-Platform** - Available for macOS, Windows, and Linux\n\n## ⚡ Quick Start\n\n1. **Download \u0026 Install** - Get AxonOps Workbench from [axonops.com/workbench/download](https://axonops.com/workbench/download/)\n2. **Set up Podman or Docker** - Required for running local clusters only\n3. **Create a Workspace** - Organize your clusters and connections\n4. **Connect to Cassandra** - Support for Apache Cassandra, DataStax Enterprise, and Astra DB\n5. **Start Exploring** - Use the CQL console and query tracing\n\n---\n\n## 🎯 Key Features at a Glance\n\n\u003cdiv align=\"center\"\u003e\n\n| Feature | Description |\n|---------|-------------|\n| 🖥️ **CQL Console** | Advanced editor with syntax highlighting, auto-completion |\n| 🔍 **Query Tracing** | Deep performance analysis with execution plans and bottleneck detection |\n| 🏃 **Local Clusters** | Spin up Cassandra clusters instantly with Docker/Podman integration |\n| 🔒 **SSH Tunneling** | Secure remote connections without external tools |\n| 📁 **Workspaces** | Organize and share cluster configurations via source control |\n| 🌍 **Multi-Language** | Available in English, Spanish, French, Arabic, Chinese, and more |\n| ⌨️ **Command Line Interface** | Powerful CLI for automation and launching CQLSH on the command line using workspace connections |\n\n\u003c/div\u003e\n\n---\n\n## 📥 Download and Install\n\n### 🎯 Recommended Installation\n\nYou can download a specific release from project [releases](https://github.com/axonops/axonops-workbench/releases), for the best experience we recommend downloading stable releases of AxonOps Workbench directly from our website:\n\n\u003cdiv align=\"center\"\u003e\n\n  **[⬇️ Download](https://axonops.com/workbench/download/)**\n\n  Available for macOS, Windows, and Linux\n\u003c/div\u003e\n\n### 🍺 Homebrew (macOS)\n\nFor macOS users, you can also install AxonOps Workbench using [Homebrew](https://brew.sh/):\n\n```sh\n# Optional: set applications directory to your $HOME\nexport HOMEBREW_CASK_OPTS=\"--appdir=~/Applications\"\nbrew tap axonops/homebrew-repository\nbrew install --cask axonopsworkbench\n```\n\nIf you'd like to use a `beta` release use instead\n\n```sh\nbrew install --cask axonopsworkbench-beta\n```\n\nand for the daily internal builds (used for testing and development purposes) use\n\n```sh\nbrew install --cask axonopsworkbench-internal\n```\n\n## 🐳 Docker or Podman Requirements for running Local Clusters\n\n**IMPORTANT - YOU ONLY NEED THIS TO DEPLOY CLUSTERS LOCALLY ON YOUR MACHINE, NOT TO USE THE APP.**\n\nTo run local Cassandra clusters using AxonOps Workbench, you'll need either Docker or Podman installed with the Compose plugin. Recent versions of both include Compose by default.\n\n### Setup Instructions\n1. Install [Docker Desktop](https://www.docker.com/products/docker-desktop/) or [Podman](https://podman.io/)\n2. Ensure the Compose plugin is available\n3. AxonOps Workbench will automatically detect installations in standard paths\n4. For custom installations, configure paths in application settings\n\n\u003cimg width=\"864\" alt=\"Docker Settings\" src=\"https://github.com/user-attachments/assets/3696af51-2f13-44eb-956a-7b8751c8abd9\" /\u003e\n\n## 🎨 Features Showcase\n\n### 📝 Enhanced CQL Console\nExperience the most advanced CQL editor with syntax highlighting, auto-completion, query history, and multi-tab support.\n\n![Enhanced_CQL_Console](https://github.com/user-attachments/assets/225cc8f3-d1e7-493c-bd73-b8186baa404d)\n\n### 🔍 Advanced Query Tracing\nDeep dive into query performance with detailed tracing, execution plans, and bottleneck identification.\n\n![Advanced_query_tracing](https://github.com/user-attachments/assets/346cbdc4-60f2-4482-9a57-874919a4f711)\n\n### 📁 Workspace Management\nOrganize your clusters into workspaces and securely share configurations through source control.\n\n\u003cimg width=\"1678\" alt=\"Screenshot 2024-08-23 at 10 07 50\" src=\"https://github.com/user-attachments/assets/42be7bd5-6fa6-4881-8c30-42ab96c2ae45\"\u003e\n\n### 🏃 Local Cluster Management\nSpin up local Cassandra clusters instantly for development and testing with just one click.\n\n\u003cimg width=\"1699\" alt=\"Screenshot 2024-08-23 at 10 13 16\" src=\"https://github.com/user-attachments/assets/0d3cdfe9-4266-4254-b9d1-54d90d7cbdfe\"\u003e\n\n### 🔒 Built-in SSH Tunneling\nConnect securely to remote clusters through SSH tunnels without external tools or complex configurations.\n\n\u003cimg width=\"981\" alt=\"Screenshot 2024-08-23 at 07 50 46\" src=\"https://github.com/user-attachments/assets/d26aee76-c34a-4495-a89b-85896e2590e5\"\u003e\n\n### ⌨️ Command Line Interface\nAutomate your workflow with powerful CLI commands for workspace and connection management, perfect for CI/CD pipelines and server environments.\n\n[📚 View Complete CLI Documentation](docs/cli.md)\n\n### 🚀 Additional Features\n\n- **🔐 Secure Credential Management** - Store and manage connection credentials securely in your system keychain\n- **📊 Schema Visualization** *(Coming Soon)* - Visual representation of keyspaces, tables, and relationships\n- **🎯 Smart Auto-completion** - Context-aware CQL suggestions and table/column name completion\n- **📝 Query History** - Access and search through your previously executed queries\n- **🔄 Import/Export** - Export query results to CSV, JSON, or other formats\n- **🌐 Multi-cluster Support** - Connect to multiple clusters simultaneously with easy switching\n- **🌍 Internationalization** - Available in multiple languages including English, Spanish, French, Arabic, Chinese, and more\n- **⚡ Performance Metrics** Real-time cluster health and performance monitoring via AxonOps\n- **🔧 Table Operations** - Visual tools for creating, altering, and managing tables\n- **📁 Data Import/Export** - Bulk data operations with progress tracking\n- **🔍 Full-text Search** - Search across your entire cluster metadata\n\n## 📋 Software Bill of Materials (SBOM)\n\nThis project provides Software Bill of Materials (SBOM) files with each release, offering transparency into our software components and dependencies. SBOMs help users and organizations understand exactly what components are included in our software, enabling better security and compliance management.\n\n### Available SBOM Formats\n- **CycloneDX** (`sbom.cyclonedx.json`): A lightweight SBOM standard that provides detailed component information and security context\n- **SPDX** (`sbom.spdx.json`): A comprehensive format focusing on software licensing and component identification\n\n### Benefits of Our SBOM\n- 🛡️ **Security**: Easily identify and track known vulnerabilities in dependencies\n- 📜 **Compliance**: Verify license obligations for all included components\n- 🔍 **Transparency**: Clear visibility into the software supply chain\n- ⚡ **Risk Management**: Better understand and assess potential risks in the software stack\n\nYou can find our SBOM files in each [release](https://github.com/axonops/axonops-workbench/releases) as part of the release artifacts. These files are automatically generated during our build process to ensure they remain current with each release.\n\n### Using SBOM Files\n1. Download the SBOM file in your preferred format from the release assets\n2. Use SBOM analysis tools:\n   - `cyclonedx-cli` for CycloneDX files\n   - `spdx-tools` for SPDX files\n3. Integrate with your security and compliance workflows\n4. Monitor for vulnerabilities in included components\n\nWe maintain these SBOM files as part of our commitment to software supply chain security and transparency. They are updated with each release to reflect the current state of our software dependencies.\n\n## 🛠️ Development\n\nWant to contribute or run AxonOps Workbench in development mode? Follow these instructions:\n\n### 📋 Requirements\n\n- Node.js \u003e= 20.15.0\n- pnpm \u003e= 10.7.0\n- Python \u003e= 3.12\n\n### 🚀 Installation \u0026 Running\n\n1. Clone this repository\n   ```sh\n   git clone https://github.com/axonops/axonops-workbench.git\n   cd axonops-workbench\n   ```\n\n2. Install Python dependencies\n   ```sh\n   pip3 install -r requirements.txt\n   ```\n\n3. Install required tools (downloads CQLSH binaries from [axonops-workbench-cqlsh](https://github.com/axonops/axonops-workbench-cqlsh/releases/latest))\n   ```sh\n   ./tools/install_tools.sh\n   ```\n\n4. Install Node.js dependencies\n   ```sh\n   pnpm i\n   ```\n\n5. Run in development mode\n   ```sh\n   pnpm start\n   ```\n\n### 🧪 Testing\n\nAxonOps Workbench includes a comprehensive test suite. See our [Testing Guide](TESTING.md) for detailed information on:\n\n- Running unit tests\n- Writing new tests\n- Test architecture and best practices\n- Continuous integration setup\n\nQuick test commands:\n```sh\n# Run all tests\npnpm test\n\n# Run tests with coverage report\npnpm run test:coverage\n\n# Run tests in watch mode (for development)\npnpm run test:watch\n```\n\n### 🤝 Contributing\n\nWe welcome contributions from the community! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting pull requests. The guide covers:\n\n- Code of conduct and community guidelines\n- Development workflow and branching strategy\n- Coding standards and best practices\n- How to submit bug reports and feature requests\n- Pull request process and review guidelines\n- License agreements and legal requirements\n\nKey points for contributors:\n- Fork the repository and create feature branches from `main`\n- Follow the existing code style and conventions\n- Write tests for new features and bug fixes\n- Update documentation as needed\n- Sign our [Contributor License Agreement (CLA)](CLA.md) by following the bot instructions on your first PR\n- All contributors must sign the CLA before their PRs can be merged\n\n### 🐛 Debugging\n\n- Set `AXONOPS_DEV_TOOLS=true` environment variable to open developer tools on startup\n- In VSCode, use the `Main + Renderer` compound launch configuration to debug both processes simultaneously\n\n### 📦 Packaging\n\nIf you'd like to create your own distribution package, you will need to install `electron-builder` and then run the following:\n\n```sh\n# builds linux deb, rpm and tar.gz\npnpm run linux\n# OSX dmg and zip\npnpm run mac\n# windows\npnpm run win\n```\n\nSee the `packages.json` for other build options.\n\n### 🧹 Cleaning Up Between Development Builds\n\nDevelopment builds may not be backwards compatible. Clean up as follows:\n\n#### 🐧 Linux and macOS:\n1. Delete folders with prefix `.axonops-` in the home folder\n2. Remove all keys with prefix `AxonOps` from the OS Keychain\n\n#### 🪟 Windows:\n1. Delete the folder with prefix `axonops-` in `C:\\Users\\{username}`\n2. Delete the folder with prefix `AxonOps` in `C:\\Users\\{username}\\AppData\\Roaming` or `%appData%`\n3. Remove all credentials with prefix `AxonOps` from Windows Credential Manager\n4. In Registry Editor, navigate to `Computer\\HKEY_LOCAL_MACHINE\\SOFTWARE\\AxonOpsWorkbenchClustersSecrets` (or `AxonOpsDeveloperWorkbenchClustersSecrets`) and delete the entire key/folder\n\n## 🙏 Acknowledgements\n\nAxonOps Workbench builds upon the foundation laid by several open-source projects, particularly Apache Cassandra. We extend our sincere gratitude to the Apache Cassandra community for their outstanding work and contributions to the field of distributed databases.\n\nApache Cassandra is a free and open-source, distributed, wide-column store, NoSQL database management system designed to handle large amounts of data across many commodity servers, providing high availability with no single point of failure.\n\n### Apache Cassandra Resources\n\n- **Official Website**: [cassandra.apache.org](https://cassandra.apache.org/)\n- **Source Code**: Available on [GitHub](https://github.com/apache/cassandra) or the Apache Git repository at `gitbox.apache.org/repos/asf/cassandra.git`\n- **Documentation**: Comprehensive guides and references available at the [Apache Cassandra website](https://cassandra.apache.org/)\n\nAxonOps Workbench incorporates and extends functionality from various Cassandra tools and utilities, enhancing them to provide a seamless desktop experience for Cassandra DB developers and DBAs.\n\nWe encourage users to explore and contribute to the main Apache Cassandra project, as well as to provide feedback and suggestions for AxonOps Workbench through our [GitHub discussions](https://github.com/axonops/axonops-workbench/discussions/categories/ideas) and [issues](https://github.com/axonops/axonops-workbench/issues/new/choose) pages.\n\n## 💬 Community \u0026 Support\n\n### Get Involved\n- 💡 **Share Ideas**: Visit our [GitHub Discussions](https://github.com/axonops/axonops-workbench/discussions/categories/ideas) to propose new features\n- 🐛 **Report Issues**: Found a bug? [Open an issue](https://github.com/axonops/axonops-workbench/issues/new/choose)\n- 🤝 **Contribute**: We welcome pull requests! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines\n- ⭐ **Star Us**: If you find AxonOps Workbench useful, please star our repository!\n\n### Stay Connected\n- 🌐 **Website**: [axonops.com](https://axonops.com)\n- 📧 **Contact**: Visit our website for support options\n\n## 📊 Download Statistics\n\nWe track download statistics from this Github project for all AxonOps Workbench releases to better understand usage patterns and platform adoption. These reports are automatically generated weekly via the Github public APIs and provide insights into:\n\n- **Total Downloads**: Overall download counts across all releases\n- **Platform Distribution**: Downloads broken down by Windows, macOS, and Linux\n- **Release Adoption**: How quickly new releases are being adopted\n- **Latest Release Performance**: Detailed statistics for the most recent release\n\n### 📈 View Reports\n\n- **[Latest Download Report](reports/latest.md)** - View the most recent weekly statistics\n- **[All Reports](reports/)** - Browse historical download reports\n\nThese reports help us:\n- Understand which platforms need more focus\n- Track the success of new releases\n- Make data-driven decisions about feature development\n- Ensure we're meeting our community's needs\n\n***\n\n## 📄 Legal Notices\n\n*This project may contain trademarks or logos for projects, products, or services. Any use of third-party trademarks or logos are subject to those third-party's policies.*\n\n- **AxonOps** is a registered trademark of AxonOps Limited.\n- **Apache**, **Apache Cassandra**, **Cassandra**, **Apache Spark**, **Spark**, **Apache TinkerPop**, **TinkerPop**, **Apache Kafka** and **Kafka** are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries.\n- **DataStax** is a registered trademark of DataStax, Inc. and its subsidiaries in the United States and/or other countries.\n- **Elasticsearch** is a trademark of Elasticsearch B.V., registered in the U.S. and in other countries.\n- **Docker** is a trademark or registered trademark of Docker, Inc. in the United States and/or other countries.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxonops%2Faxonops-workbench","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faxonops%2Faxonops-workbench","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxonops%2Faxonops-workbench/lists"}