mcpField
F
frida-agent-builder

frida-agent-builder

github.com/rudra-raviDevelopment7103 installsUpdated 25w ago
Repository

About frida-agent-builder

Frida Agent Builder is a skill for creating reusable Frida agents and multi-script projects, aimed at developers structuring TypeScript agents. It provides a scaffold and conventions for hook modules, logging, and RPC usage.

Key features

  1. 01Scaffold a TypeScript agent
  2. 02Separate files by hook family
  3. 03Export init() for each hook family
  4. 04Use structured JSON logging for complex values
  5. 05Add rpc.exports when needed

Use cases

  1. 01Grow a single hook into a multi-script project
  2. 02Set up a Frida agent with Java support
  3. 03Standardize hook and logging organization

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rudra-ravi/frida-skills --skill frida-agent-builder

After installing, type/frida-agent-builderin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
agent-patterns.md
scripts/
scaffold-frida-agent.py

Details

From the project README

Frida Agent Builder

Use this skill for reusable Frida agents and multi-script projects.

Project Shape

Prefer a small TypeScript agent when scripts will grow beyond a single hook:

agent/
├── package.json
├── tsconfig.json
├── src/
│   ├── index.ts
│   ├── log.ts
│   └── hooks/
└── dist/

For Frida 17 and Java APIs in bundled agents, include frida-java-bridge when required by the build/runtime style.

Build Rules

  • Keep one hook family per file.
  • Export an init() function per hook family and call it from src/index.ts.
  • Use structured logging with tags and JSON for complex values.
  • Add rpc.exports only for host-controlled actions or test probes.
  • Avoid global broad hooks unless the task explicitly requires discovery.
  • Keep generated artifacts out of source control unless the repository convention includes them.

Scaffold Script

Use scripts/scaffold-frida-agent.py to create a minimal TypeScript Frida agent:

python3 /path/to/frida-agent-builder/scripts/scaffold-frida-agent.py ./agent --java

Then install and build:

npm install
npm run build

References

Read references/agent-patterns.md for project conventions, RPC patterns, host command examples, and packaging notes.

Comments

Markdown supported