Barbatos

Multiplatform Runtime Debugger & MCP Server.

"Understanding the language of systems, revealing hidden states, and reconciling the gap between developer and machine."

Barbatos Demo

Quick Installation

curl -sSL https://barbatos.victorlpgazolli.dev/install.sh | bashCopy

Recommended for macOS (ARM64), Linux (x64/ARM64), and WSL.

AI-Driven Debugging

Connect Barbatos to your AI agent via the Model Context Protocol (MCP) to automate runtime exploration and manipulation. Your AI assistant can seamlessly:

State Exploration

"Locate the active LoginState instance and tell me the value of its errorCode field."

Method Hooking

"Tell me the parameters passed to the MyViewModel.fetchData method every time it is called."

Live Edit

"Change the isPremium boolean on the active UserProfile instance to true to test the UI state."

Core Capabilities

Class Discovery

Real-time enumeration of loaded Java/Kotlin classes with package filtering.

Deep Inspection

Recursive traversal of object hierarchies including Fields, Maps, and Collections.

Method Hooking

Intercept execution flow, inspect arguments, and capture return values live.

Live Field Editing

Modify primitive field values (String, Int, Boolean) in real-time to test hypotheses.

Architecture Pipeline

Native TUI
MCP Client
↓
Python Bridge
↓
Frida JS Agent
↓
Multiplatform Runtime
↓
Target App

MCP Server Setup

Add this to your ~/.claude.json:

{
    "mcpServers": {
        "barbatos-debugger": {
            "command": "barbatos-bridge",
            "args": ["mcp"]
        }
    }
}
Copy

Note: The unified bridge automatically handles Frida connection for the MCP server.

OpenApi specification

Barbatos provides an API that is accessible through the bridge.

View API Docs >