Downloads and SDK

Everything you need to use CatSuite and write extensions, in one place. The app is free, with no subscription and no paywall, and the developer tools live at official addresses: GitHub for downloads and source code and the Visual Studio Code Marketplace for the CatSuite Studio extension.

CatSuite app #

CatSuite is an Android app. Download it from the official store:

• Google Play — CatSuite

Every module — interceptor, browser, network proxy, Repeater, Intruder, Discoverer, Decoder, SSL/TLS Analyzer, extensions and workflows — ships inside the app. Data stays on the device. Start with Getting started.

Official GitHub repository #

The github.com/netcattest/catsuite repository brings together the source code and the downloads of the developer tools:

The ready-made files live in the repository's published releases, each one with its own SHA-256 checksum file:

Check the integrity #

Compare the SHA-256 of each downloaded file with the value published in the SHA256SUMS.txt of the same release.

Get-FileHash .\catsuite-sdk-1.4.0.zip -Algorithm SHA256

sha256sum -c --ignore-missing SHA256SUMS.txt

Extension SDK 1.4.0 #

The SDK brings together everything to build CatSuite plugins: the API types, the reference runtime, the schemas, fifteen editable examples and six workflow templates.

• Download SDK 1.4.0 (ZIP)
• Explore the sdk folder on GitHub
• Full SDK guide

The ZIP extracts a catsuite-sdk folder. You do not need to install anything on the device to run extensions: the QuickJS engine runs inside the app and the global cat object is already available to your code. To write them, pick where you prefer to work:

• In VS Code, with CatSuite Studio: SDK suggestions, validation, a local preview and signed .catplug packages.
• In the browser, with the extension IDE: editor with highlighting, autocomplete, validation, a simulator and .catplug export, with nothing to install.
• Read the contract in the JavaScript API reference and the manifest and .catplug package.

declare const cat: {
  readonly apiVersion: 1;
  readonly sdkVersion: "1.4.0";
  events: { on(name: "http.request" | "http.response" | "http.complete", handler: (message: CatMessage) => void | Promise<void>): void };
  proxy: { onRequest(handler: (m: CatMessage) => CatMessage | void): void; onResponse(handler: (m: CatMessage) => CatMessage | void): void };
  http: { send(request: CatRequest): Promise<CatMessage> };
  ui: { tab: { register(options: { id: string; title: CatText; components: CatComponent[] }): void } };
  findings: { add(finding: CatFinding): Promise<string> };
};

CatSuite Studio for VS Code #

CatSuite Studio is the official CatSuite extension for Visual Studio Code: SDK suggestions as you type cat., ready-made templates, continuous validation, a local preview with fixtures and signed .catplug package builds.

• Install from the Visual Studio Marketplace
• Download the 1.2.0 VSIX
• Source code on GitHub

From the Marketplace, use the VS Code Extensions view and search for CatSuite Studio, or the command line:

code --install-extension NetCatTest.catsuite-studio

With the VSIX downloaded, open Extensions → ⋯ → Install from VSIX in VS Code and select the file, or use the command line:

code --install-extension catsuite-studio-1.2.0.vsix

CatSuite Studio requires Visual Studio Code 1.100.0 or newer. See the full CatSuite Studio guide.

Extension IDE #

The web IDE runs entirely in the browser: nothing is sent to servers and the simulator makes no network connections. You create from scratch or from an example, validate, run it in a simulator faithful to the app and export a .catplug ready to import into CatSuite. See the full IDE guide.

CatBridge connector #

CatBridge is optional and runs on your computer. The ready-made distribution does not require Go: download the package for your system, extract it and start the service. Pairing uses a 24-digit numeric code, with no QR Code. The steps are in Install and pair CatBridge, and the tool catalog in Capabilities and tools.

Machine-readable documentation #

Every page in this documentation has a Markdown version: append .md to its address. There is also a plain-text index for language models:

• CatSuite llms.txt — bilingual index of the app and the documentation.
• llms-full.txt — complete documentation in Portuguese and English in a single file.

Next step #

• Extension SDK 1.4.0
• CatSuite Studio for VS Code
• Install and pair CatBridge