Refactor build system and reorganize test structure

- Add ida-cmake agent configuration for automated builds
- Add comprehensive CLAUDE.md documentation
- Update CMakeLists.txt and prep-cmake.bat for improved build process
- Reorganize test_scripts/trigger-native to test_addons for clarity
- Add CMakeLists.txt files for addon templates (loader, plugin, triton)
- Improve project documentation and structure

Author: 0xeb

.claude/agents/ida-cmake.md

@@ -0,0 +1,78 @@
+---
+name: ida-cmake
+description: Use this agent to compile/build IDA Pro extensions including plugins, idalib applications, processor modules, or file loaders (all known as IDA addons) using the IDA C++ SDK. Used this agent to create a new addon template or for troubleshooting build issues, configuring the IDASDK environment, or integrating ida-cmake into existing projects.
+model: sonnet
+color: orange
+---
+
+IDA Pro addons usually refer to: plugins, processor modules, file loaders, or idalib standalone applications.
+You are an expert in building these addons using the ida-cmake CMake scripts located in `$IDASDK/ida-cmake`.
+
+- Refer to `$IDASDK/ida-cmake/README.md` for documentation on how to use `ida-cmake`.
+- Refer to `$IDASDK/ida-cmake/templates/plugin/` for example CMakeLists.txt file and plugin
+- Refer to `$IDASDK/ida-cmake/templates/loader` for example CMakeLists.txt file and loader
+- Refer to `$IDASDK/ida-cmake/templates/procmod` for example CMakeLists.txt file and processor module
+- Refer to `$IDASDK/ida-cmake/templates/idalib` for example CMakeLists.txt file and idalib application
+- Refer to `$IDASDK/include` for SDK headers. All headers have docstrings, use them to explain SDK usage and lookup APIs.
+- Refer to `$IDASDK/plugins`, `$IDASDK/loaders`, `$IDASDK/module` for SDK example and how APIs are used in practice.
+
+You must open and read those files above to answer the user correctly to answer all things IDA compiling and building related questions.
+
+## CMake Usage
+
+The ida-cmake provides clean interface libraries:
+- `idasdk::plugin` - For IDA plugins
+- `idasdk::loader` - For file loaders
+- `idasdk::procmod` - For processor modules
+- `idasdk::idalib` - For standalone idalib applications
+
+## Example Usage
+
+For quick reference, here's a skeleton CMakeLists.txt begining:
+
+```cmake
+cmake_minimum_required(VERSION 3.27)
+project(myplugin)
+set(CMAKE_CXX_STANDARD 17)
+
+# Include IDA SDK bootstrap
+include($ENV{IDASDK}/ida-cmake/bootstrap.cmake)
+find_package(idasdk REQUIRED)
+```
+
+Now, for a plugin, use the `ida_add_plugin` function:
+
+```cmake
+ida_add_plugin(myplugin
+    SOURCES
+        main.cpp
+    DEBUG_ARGS
+        "-t -z10000"
+)```
+
+...and for a file loader, use the `ida_add_loader` function:
+
+```cmake
+ida_add_loader(myloader
+    SOURCES
+        loader.cpp
+    DEBUG_ARGS
+        "-c -A"  # Common loader debug args
+)```
+
+...and for a standalone idalib application, use the following CMakeLists.txt:
+
+```cmake
+ida_add_idalib_exe(myidalib
+    SOURCES
+        main.cpp
+    DEBUG_ARGS
+        "${IDASDK}/ida-cmake/samples/wizmo32.exe.i64"
+)```
+
+To build an addon, just use something like from the addon source folder:
+
+```bash
+cmake -B build
+cmake --build build --config RelWithDebInfo
+```

CLAUDE.md

@@ -0,0 +1,91 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+# QScripts - IDA Pro Productivity Plugin
+
+QScripts is an IDA Pro plugin that enables automatic script execution upon file changes, supporting hot-reload development workflows with Python, IDC, and compiled plugins.
+
+## Build Commands
+
+### 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/`
+
+### Build with ida-cmake agent
+Always use the ida-cmake agent for building:
+```
+Task with subagent_type="ida-cmake"
+```
+
+### Manual build (Windows)
+```bash
+# Configure CMake
+prep-cmake.bat
+
+# Build
+prep-cmake.bat build
+
+# Clean build
+prep-cmake.bat clean
+```
+
+## Architecture
+
+### Core Components
+
+**Main Plugin (`qscripts.cpp`)**
+- Implements `qscripts_chooser_t`: Non-modal chooser UI for script management
+- File monitoring system with configurable intervals (default 500ms)
+- Dependency tracking and automatic reloading
+- Integration with IDA's recent scripts system (shares same list)
+
+**Script Management (`script.hpp`)**
+- `fileinfo_t`: File metadata and modification tracking
+- `script_info_t`: Script state management (active/inactive/dependency)
+- `active_script_info_t`: Extends script_info with dependency handling
+- Dependency resolution with recursive parsing and cycle detection
+
+### Key Features Implementation
+
+**Dependency System**
+- Dependencies defined in `.deps.qscripts` files
+- Supports `/reload` directive for Python module reloading
+- `/triggerfile` directive for custom trigger conditions
+- `/notebook` mode for cell-based execution
+- Variable expansion: `$basename$`, `$env:VAR$`, `$pkgbase$`, `$ext$`
+
+**File Monitoring**
+- Uses qtimer-based polling (not OS-specific watchers yet)
+- Monitors active script and all dependencies
+- Trigger file support for compiled plugin development
+
+## IDA SDK and API Resources
+
+When answering SDK/API questions, search and read from:
+- **SDK Headers**: `$IDASDK/include` - All headers have docstrings
+- **SDK Examples**: `$IDASDK/plugins`, `$IDASDK/loaders`, `$IDASDK/module`
+
+## Testing
+
+Test scripts are located in `test_scripts/`:
+- `dependency-test/` - Simple dependency examples
+- `pkg-dependency/` - Package dependency examples
+- `notebooks/` - Notebook mode examples
+- `trigger-native/` - Compiled plugin hot-reload examples
+
+## Plugin States
+
+Scripts can be in three states:
+1. **Normal**: Shown in regular font
+2. **Active** (bold): Currently monitored for changes
+3. **Inactive** (italics): Previously active but monitoring disabled
+
+## Important Implementation Notes
+
+- Plugin uses IDAX framework for enhanced UI capabilities
+- 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

CMakeLists.txt

@@ -1,16 +1,28 @@
-cmake_minimum_required(VERSION 3.12 FATAL_ERROR)
-
-project(qscripts)
-
-include($ENV{IDASDK}/ida-cmake/common.cmake)
-
-set(CMAKE_CXX_STANDARD 17)
-set(CMAKE_CXX_STANDARD_REQUIRED ON)
-
-list(APPEND DISABLED_SOURCES utils_impl.cpp) # included file
-set(PLUGIN_NAME              qscripts)
-set(PLUGIN_SOURCES           qscripts.cpp ida.h script.hpp ${DISABLED_SOURCES})
-
-set_source_files_properties(${DISABLED_SOURCES} PROPERTIES LANGUAGE "")
-
-generate()
+cmake_minimum_required(VERSION 3.27)
+project(qscripts)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# Include IDA SDK bootstrap
+include($ENV{IDASDK}/ida-cmake/bootstrap.cmake)
+find_package(idasdk REQUIRED)
+
+# Convert paths to native format
+set(SAMPLE_IDB "${IDA_CMAKE_DIR}/samples/wizmo32.exe.i64")
+file(TO_NATIVE_PATH "${SAMPLE_IDB}" SAMPLE_IDB)
+
+# Disabled sources
+list(APPEND DISABLED_SOURCES utils_impl.cpp)
+set_source_files_properties(${DISABLED_SOURCES} PROPERTIES LANGUAGE "")
+
+# Add plugin
+ida_add_plugin(qscripts
+    SOURCES
+        qscripts.cpp
+        ida.h
+        script.hpp
+        ${DISABLED_SOURCES}
+    DEBUG_ARGS
+        "${SAMPLE_IDB}"
+)

README.md

@@ -151,7 +151,7 @@ Now, simply use your favorite IDE (or terminal) and build (or rebuild) the `hell
 
 The moment the compilation succeeds, the new binary will be detected (since it is the trigger file) then your active script will use IDA's `load_and_run_plugin()` to run the plugin again.
 
-Please check the [trigger-native](test_scripts/trigger-native/) example.
+Please check the native addons examples in [test_addons](test_addons/).
 
 # Building
 

prep-cmake.bat

@@ -15,7 +15,7 @@ if not exist %IDASDK%\include\idax\xkernwin.hpp (
     goto :eof
 )
 
-if not exist %IDASDK%\ida-cmake\common.cmake (
+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
     goto :eof

test_scripts/trigger-native/README.md test_addons/README.mdtest_scripts/trigger-native/README.md renamed to test_addons/README.md

@@ -0,0 +1,19 @@
+cmake_minimum_required(VERSION 3.27)
+project(qscripts_native)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# Include IDA SDK bootstrap
+include($ENV{IDASDK}/ida-cmake/bootstrap.cmake)
+find_package(idasdk REQUIRED)
+
+# Add loader
+ida_add_loader(qscripts_native
+    SOURCES
+        driver.cpp
+        main.cpp
+        idasdk.h
+    DEBUG_ARGS
+        "-t"
+)