Development / Local Testing

This document describes how to set up a local development environment for the repository on macOS.

Prerequisites

Python 3+ (use python3)
Node.js (LTS) and npm or pnpm for JS tooling (optional)
A physical device or emulator with frida-server or an app with an embedded frida gadget running (for dynamic tests)

Create a new Python virtual environment and activate it
```
python3 -m venv venv
source venv/bin/activate
```
Compiling the frooky agent
```
./compileAgent.sh --dev
```
Install the CLI for development
```
pip install -e .
```
Ensure which CLI version you're running
```
which frooky
```
The output must be a path within the VENV directory, typically ending with venv/bin/frooky. If not, a different version might be used instead, such as a global installation.

If you want to work on the frooky agent itself, you can also use frida as host.

Please refer to the frooky agent documentation for more information.