Skip to content
Back to search

ragoshell

Cross-platform, shell-centric MongoDB GUI and read-only MCP server built with C++17 and Qt 6 Quick (GPLv3) — https://ragoshell.com.tr

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ragipunal/ragoshell with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ragipunal/ragoshell'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ragipunal--ragoshell/badge.svg)](/listings/ragipunal--ragoshell)

HTML

<a href="/listings/ragipunal--ragoshell"><img src="/api/listings/ragipunal--ragoshell/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 116 lines
  1. # RagoShell
  2. RagoShell is a cross-platform MongoDB management tool — a community-driven continuation of the open-source Robomongo 1.4.4 codebase, modernized for current toolchains and platforms.
  3. ## What's different from the 1.4.4 codebase
  4. - **Qt 6** (tested with 6.12.x) — migrated from Qt 5.12.
  5. - **Qt Quick (QML) user interface** — the old Qt Widgets UI was rewritten in QML (`src/ragoshell-app/`) on top of a GUI-free core library (`rago-core`); the shell editor still renders through QScintilla.
  6. - **Official MongoDB drivers** — `mongo-cxx-driver` / `libbson` via [vcpkg](https://vcpkg.io); the old embedded `mongo` shell codebase was removed.
  7. - **Embedded JavaScript shell** — the shell runs inside the application on Qt's JavaScript engine (`src/ragoshell/core/engine/`: the runtime `js/shell-runtime.js`, the MongoDB host `ShellHost` on `mongocxx` and the BSON converter), the same on Windows, Linux, macOS, Android, iOS and iPadOS. There is no Node.js process and no Node.js in the packages; see `docs/Shell.md`.
  8. - **CMake + CMakePresets** — replaces the old qmake/PowerShell build system.
  9. - **Lighter startup and memory profile** — the QtWebEngine-based welcome tab was replaced with a lightweight network implementation, and the output log is bounded.
  10. - **Optional read-only MCP server** — `ragoshell-mcp` lets AI clients (Claude Code, Claude Desktop) inspect MongoDB through saved connections you explicitly allow; off by default. See `docs/McpServer.md`.
  11. - **Cross-platform local CI** — per-platform build/packaging scripts under `ci/` producing distributable archives, plus Gitea release publishing helpers.
  12. MongoDB 4.0 compatibility is preserved and tested against MongoDB 4.0.x.
  13. ## Supported platforms
  14. | Platform | Architecture | Status |
  15. |---|---|---|
  16. | Windows 10/11 | x64 | Full support — built and tested; `ci/build-windows.ps1` builds NSIS `-setup.exe`, WiX `.msi`, and portable `.zip` packages, with optional `signtool` / Azure Trusted Signing support ready (`docs/WindowsCodeSigning.md`) |
  17. | macOS 14.4+ | arm64 (Apple Silicon) | Full support (`min` macOS 14.4, latest `macosx` SDK) — `ci/build-macos.sh` builds `.dmg` and `.tar.gz` packages (ad-hoc signed by default; optional Developer ID + notarization workflow ready, `docs/MacOsCodeSigning.md`) |
  18. | Linux | x64 | Full support — Wayland and X11; `ci/build-linux.sh` builds a self-contained `.AppImage` and a system-Qt `.tar.gz` (`docs/Platforms.md`) |
  19. | iOS / iPadOS 18.0+ | arm64 | Runs on iPhone and iPad (universal `UIDeviceFamily` 1 & 2, `min` 18.0, latest `iphoneos` SDK) — touch layout, embedded shell, Keychain; no `mongodb+srv://` or GSSAPI; installed from Xcode, App Store decision open (`docs/Platforms.md`, `docs/MacOsWork.md`) |
  20. | Android 9.0+ phones and tablets | arm64 (`x86_64` emulator) | Runs on phones, tablets, and emulator (`min` API 28 / Android 9.0, target API 37 / Android 17) — touch layout, embedded shell, Android Keystore; `ci/build-android.sh` and `ci/build-android.ps1` build 16 KB page-aligned Release `.apk` and `.aab` packages with optional upload-keystore signing (`docs/AndroidCodeSigning.md`, Play listing open); no `mongodb+srv://` or GSSAPI (`docs/Platforms.md`) |
  21. ## Download
  22. Prebuilt packages are published on the project's Gitea releases page (see repository Releases).
  23. ## Build
  24. Prerequisites:
  25. - CMake 3.20+ and Ninja
  26. - A C++17 compiler (MSVC on Windows, GCC/Clang elsewhere)
  27. - [vcpkg](https://vcpkg.io) — dependencies are declared in `vcpkg.json`
  28. - Qt 6.12 with Qt Quick and Quick Controls 2
  29. - Node.js is optional: only the translation check (`node ci/check-i18n.mjs`) and the MCP end-to-end test use it
  30. ```bash
  31. # Windows (uses presets that locate Qt under C:\Qt)
  32. cmake --preset windows
  33. cmake --build --preset windows-debug # or windows-release
  34. # Linux / macOS (set VCPKG_ROOT and Qt6_DIR first)
  35. cmake --preset linux-debug # or macos-debug
  36. cmake --build --preset linux-debug
  37. ```
  38. The app is `ragoshell` (`build/<preset>/src/ragoshell-app/`); the MCP server `ragoshell-mcp` and the unit tests (`rago_unit_tests`) build alongside it.
  39. See `docs/BuildRagoShellOnWindows.md`, `docs/BuildRagoShellOnMacAndLinux.md` and `ci/README.md` for details, and `docs/RemoteBuild.md` for building the macOS and Linux packages from a Windows PC.
  40. ### More documents
  41. `docs/DesignSystem.md` (how the interface is built and its rules), `docs/UiMatrix.md` (how every screen was checked), `docs/Platforms.md` (what runs where), `docs/Shell.md` (the embedded shell), `docs/MacOsWork.md` (what needs a Mac), `docs/TodoMac.md` (the open work, for a session on the Mac), `docs/McpServer.md`, `docs/ManualTests.md`, `docs/Roadmap.md` (the website, account service, hosting and business plan; in Turkish), `docs/Brand.md` (how the name RagoShell is written and used).
  42. ### Local CI / packaging
  43. ```powershell
  44. # Windows / Android (Windows host)
  45. .\ci\build-windows.ps1 -Version 2.1.0
  46. .\ci\build-android.ps1 -Version 2.1.0
  47. ```
  48. ```bash
  49. # Linux / macOS / Android (Linux or macOS host)
  50. ./ci/build-linux.sh 2.1.0
  51. ./ci/build-macos.sh 2.1.0
  52. ./ci/build-android.sh 2.1.0
  53. ```
  54. Packages land in `dist/` (git-ignored). Release publishing to Gitea:
  55. ```bash
  56. ./ci/gitea-release.sh v2.1.0 # bash
  57. .\ci\gitea-release.ps1 v2.1.0 # PowerShell
  58. ```
  59. The token is read from `GITEA_TOKEN`, `ci/.env`, or an interactive prompt. See `ci/README.md`.
  60. ### Test data
  61. The live unit tests and the screen checks expect a MongoDB 4.0 server on `localhost:27017` with a `samples` database; the tests skip themselves when no server answers. The author keeps a docker setup for it in `dev/mongo-test/`, which is git-ignored and therefore not part of the repository; any `mongo:4.0` container with sample data does the same job. How the screens are checked against it: `dev/ui-shots/README.md`.
  62. ## Translating RagoShell
  63. The UI is available in 15 languages (English, हिन्दी, 简体中文, Español, Português (Brasil), Русский, Deutsch, Français, 日本語, العربية, Türkçe, Azərbaycan dili, Қазақ тілі, Кыргызча, Oʻzbekcha); Arabic is laid out right to left. Pick one in Preferences, or start with `--lang <code>` (for example `ragoshell --lang ja`). How the translations are made and checked is in `docs/Localization.md`.
  64. The translations are machine-drafted from the glossary and checked mechanically; they still need a review by native speakers, and corrections are welcome.
  65. ```bash
  66. # refresh the .ts files after changing UI text (strings in QML: qsTr, in C++: tr)
  67. cmake --build build/windows --config Release --target update_translations
  68. # translate with Qt Linguist (src/ragoshell-app/i18n/ragoshell_<lang>.ts), follow i18n/GLOSSARY.md, then:
  69. node ci/check-i18n.mjs
  70. # see the result without waiting for a translator: a pseudo-locale shows untranslatable text
  71. python ci/pseudo-translate.py src/ragoshell-app/i18n/ragoshell_de.ts pseudo.ts
  72. lrelease pseudo.ts -qm pseudo.qm && ragoshell --qm-file pseudo.qm
  73. ```
  74. Adding a language takes one row in `src/ragoshell/core/utils/LanguageCatalog.cpp`, its code in `RAGO_UI_LANGUAGES` in `src/ragoshell-app/CMakeLists.txt` (CMake then creates the empty `.ts` file), and a glossary column.
  75. ## History and attribution
  76. RagoShell is based on the open-source Robomongo 1.4.4 codebase, whose development ended in 2021. Attribution for the original work lives in `COPYRIGHT`.
  77. ## License
  78. Copyright of the original codebase belongs to its original authors (2014-2021); RagoShell modifications are copyright of the RagoShell contributors.
  79. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See `LICENSE`, `LICENSE.LGPLv3`, `THIRD-PARTY-NOTICES.txt`, and <https://www.gnu.org/licenses/> for details.
  80. RagoShell uses the Qt 6 Toolkit (Community / Open Source Edition) under the GNU LGPLv3 / GPLv3, QScintilla under the GNU GPLv3, and official MongoDB C/C++ drivers and OpenSSL 3 under the Apache License 2.0. The mobile builds also bundle the DejaVu Sans font (`assets/fonts/DEJAVU-LICENSE`). Full copyright and license notices for all third-party components are listed in `THIRD-PARTY-NOTICES.txt` and inside the application under **Help → Open-Source Licenses**.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.