feat: Improve build system resilience and multi-platform releases

- Auto-fetch idacpp into build folder if missing from IDASDK
- Remove idax dependency (no longer needed)
- Simplify CI workflow (remove manual idacpp cloning)
- Add automatic zip packaging for releases containing all platforms
- Update documentation with new prerequisites and CI/CD instructions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: 0xeb

.github/workflows/build.yml

@@ -32,9 +32,6 @@ jobs:
           git clone --depth 1 https://github.com/HexRaysSA/ida-sdk ida-sdk
           mkdir -p "${IDASDK}"
           git clone --depth 1 https://github.com/allthingsida/ida-cmake "${IDASDK}/ida-cmake"
-          mkdir -p "${IDASDK}/include"
-          git clone --depth 1 https://github.com/allthingsida/idax "${IDASDK}/include/idax"
-          git clone --depth 1 https://github.com/allthingsida/idacpp "${IDASDK}/include/idacpp"
 
       - name: Configure (Linux)
         run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
@@ -64,9 +61,6 @@ jobs:
           git clone --depth 1 https://github.com/HexRaysSA/ida-sdk ida-sdk
           mkdir -p "${IDASDK}"
           git clone --depth 1 https://github.com/allthingsida/ida-cmake "${IDASDK}/ida-cmake"
-          mkdir -p "${IDASDK}/include"
-          git clone --depth 1 https://github.com/allthingsida/idax "${IDASDK}/include/idax"
-          git clone --depth 1 https://github.com/allthingsida/idacpp "${IDASDK}/include/idacpp"
 
       - name: Configure (macOS)
         run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
@@ -96,9 +90,6 @@ jobs:
           git clone --depth 1 https://github.com/HexRaysSA/ida-sdk ida-sdk
           mkdir -p "${IDASDK}"
           git clone --depth 1 https://github.com/allthingsida/ida-cmake "${IDASDK}/ida-cmake"
-          mkdir -p "${IDASDK}/include"
-          git clone --depth 1 https://github.com/allthingsida/idax "${IDASDK}/include/idax"
-          git clone --depth 1 https://github.com/allthingsida/idacpp "${IDASDK}/include/idacpp"
 
       - name: Configure (Windows)
         run: cmake -S . -B build -A x64
@@ -129,15 +120,22 @@ jobs:
         run: |
           ls -la release || true
 
+      - name: Create zip package
+        run: |
+          cd release
+          zip -9 qscripts-${{ github.ref_name }}.zip qscripts.dll qscripts.so qscripts.dylib
+          ls -lh *.zip
+
       - name: Create GitHub Release and upload assets
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ github.ref_name }}
-          name: ${{ github.ref_name }}
+          name: QScripts ${{ github.ref_name }}
           draft: false
           prerelease: false
           generate_release_notes: true
           files: |
-            release/qscripts.dylib
-            release/qscripts.so
+            release/qscripts-${{ github.ref_name }}.zip
             release/qscripts.dll
+            release/qscripts.so
+            release/qscripts.dylib

CLAUDE.md

@@ -10,8 +10,8 @@ QScripts is an IDA Pro plugin that enables automatic script execution upon file
 
 ### Prerequisites
 - **IDASDK**: Environment variable must be set to IDA SDK path
-- **IDAX**: Must be installed at `$IDASDK/include/idax/`
 - **ida-cmake**: Must be installed at `$IDASDK/ida-cmake/`
+- **idacpp**: Optional - will be automatically fetched if not found at `$IDASDK/include/idacpp/`
 
 ### Build with ida-cmake agent
 Always use the ida-cmake agent for building:
@@ -84,8 +84,27 @@ Scripts can be in three states:
 
 ## Important Implementation Notes
 
-- Plugin uses IDAX framework for enhanced UI capabilities
+- Plugin uses idacpp wrapper library for enhanced C++ API
 - Shares script list with IDA's built-in "Recent Scripts" (Alt-F9)
 - Maximum 512 scripts in list (IDA_MAX_RECENT_SCRIPTS)
 - Special unload function: `__quick_unload_script` called before reload
-- Supports undo via IDA's undo system when enabled in options
+- Supports undo via IDA's undo system when enabled in options
+
+## CI/CD and Releases
+
+### Automated Builds
+- GitHub Actions builds for Linux (.so), macOS (.dylib), and Windows (.dll)
+- Runs on every push and pull request
+- CMake automatically fetches idacpp if not available in IDASDK
+
+### Creating Releases
+To create a new release with pre-built binaries:
+```bash
+git tag v1.0.0              # Create version tag
+git push origin v1.0.0      # Push tag to trigger release
+```
+This will automatically:
+1. Build qscripts for all 3 platforms
+2. Create a GitHub Release page
+3. Upload all platform binaries (.dll, .so, .dylib)
+4. Generate release notes from commits

CMakeLists.txt

@@ -8,8 +8,27 @@ set(CMAKE_CXX_STANDARD_REQUIRED ON)
 include($ENV{IDASDK}/ida-cmake/bootstrap.cmake)
 find_package(idasdk REQUIRED)
 
-# Add idacpp library
-add_subdirectory($ENV{IDASDK}/include/idacpp ${CMAKE_CURRENT_BINARY_DIR}/idacpp)
+# Add idacpp library with fallback
+# First, try to use idacpp from IDASDK
+set(IDACPP_SDK_PATH "$ENV{IDASDK}/include/idacpp")
+set(IDACPP_LOCAL_PATH "${CMAKE_CURRENT_BINARY_DIR}/idacpp")
+
+if(EXISTS "${IDACPP_SDK_PATH}/CMakeLists.txt")
+    message(STATUS "Using idacpp from IDASDK: ${IDACPP_SDK_PATH}")
+    add_subdirectory(${IDACPP_SDK_PATH} ${CMAKE_CURRENT_BINARY_DIR}/idacpp)
+else()
+    message(STATUS "idacpp not found in IDASDK, fetching to build directory...")
+
+    # Use FetchContent to download idacpp into build directory
+    include(FetchContent)
+    FetchContent_Declare(
+        idacpp
+        GIT_REPOSITORY https://github.com/allthingsida/idacpp.git
+        GIT_TAG main
+        SOURCE_DIR ${IDACPP_LOCAL_PATH}
+    )
+    FetchContent_MakeAvailable(idacpp)
+endif()
 
 # Convert paths to native format
 set(SAMPLE_IDB "${IDA_CMAKE_DIR}/samples/wizmo32.exe.i64")

prep-cmake.bat

@@ -9,12 +9,6 @@ if not defined IDASDK (
     goto :eof
 )
 
-if not exist %IDASDK%\include\idax\xkernwin.hpp (
-    echo IDAX framework not properly installed in the IDA SDK folder.
-    echo See: https://github.com/ida-cmake/idax
-    goto :eof
-)
-
 if not exist %IDASDK%\ida-cmake\idasdkConfig.cmake (
     echo ida-cmake not properly installed in the IDA SDK folder.
     echo See: https://github.com/allthingsida/ida-cmake