nibkit MCP server
Commit Nov 6, 2026Decompiles compiled iOS and macOS interface files to reveal object trees, view wiring, custom classes, and navigation graphs.
Also known as tokenbleed/nibkit
- Stars
- 5
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 6, 2026
- License
- MIT
What is nibkit MCP?
nibkit decompiles compiled iOS and macOS interface files to reveal object trees, view wiring, custom classes, and navigation graphs.
Summary generated from the project's README
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabletokenbleed/nibkit is public and reachablegithub.com/tokenbleed/nibkit ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-06github.com/tokenbleed/nibkit ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub= nibkit
image:https://github.com/tokenbleed/nibkit/actions/workflows/ci.yml/badge.svg[build status,link=https://github.com/tokenbleed/nibkit/actions/workflows/ci.yml]
Decompiler for compiled iOS/macOS interface files. Parses .nib and
.storyboardc files (the format real apps ship), extracts object structure,
wiring, custom classes, and the navigation graph. Single static Go binary,
stdlib only, cross-compiles anywhere. Also runs as an MCP server, so AI
coding tools can decode nibs directly.
strings gives you tokens. nibkit gives you relationships: which control
fires which selector, which custom class backs which scene, how navigation
flows, and what runtime attributes were set.
== Install
[source,sh]
brew install tokenbleed/tap/nibkit
or with a Go toolchain:
[source,sh]
go install github.com/tokenbleed/nibkit@latest
Prebuilt binaries for darwin and linux (arm64 and amd64) are on the https://github.com/tokenbleed/nibkit/releases[releases] page. No runtime dependencies.
== MCP server (AI tool integration)
nibkit mcp speaks the Model Context Protocol over stdio (newline-delimited
JSON-RPC, no dependencies), exposing the read-only commands as tools:
nibkit_wiring, nibkit_classes, nibkit_segues, nibkit_tree,
nibkit_all, nibkit_info. Each takes one path argument (any input the CLI
accepts, including .ipa and .app).
Claude Code:
[source,sh]
claude mcp add nibkit -- nibkit mcp
opencode (opencode.json):
[source,json]
{ "mcp": { "nibkit": { "type": "local", "command": ["nibkit", "mcp"] } } }
Generic MCP client config: command nibkit, args ["mcp"], stdio transport.
pi ships no built-in MCP client; the CLI is the same interface and extensions
can wrap nibkit mcp if needed.
The on-disk formats are documented field by field in link:docs/format.adoc[docs/format.adoc].
== Usage
[source,sh]
nibkit [command] <path...> [flags] nibkit # no args + terminal: interactive menu
[cols="2,5"] |=== |Command |What it gives you
|tree (default)
|the object graph, indented, with resolved custom-class annotations (UIClassSwapper shows the real class)
|wiring
|the high-value command: outlets (myButton -> MyViewController), actions (didTapLogin: [touchUpInside]), and runtime attributes (keyPath=value)
|classes |every custom IB class with base class and scene ID, Swift-mangled names recovered
|segues |the full navigation graph: storyboard segue templates (kind, identifier, selector, custom class) plus container relationships (tab-bar tabs, navigation roots) that never compile to segues. Deduped.
|all |classes + wiring + navigation in one report
|info |header counts only |===
Inputs: .ipa (auto-extracted), .nib, .storyboardc, .app, or any
directory walked recursively for NIBArchive nibs. Multiple paths are
aggregated.
Flags: -J / --json (single object for one nib, array for many),
--frida (generate Frida hook stubs from @IBAction wiring),
--mermaid (navigation graph as a Mermaid flowchart).
== Examples
[source,sh]
nibkit Foo.ipa # auto-extracted, no unzip step nibkit wiring Foo.app # outlets + actions + runtime attrs nibkit wiring --frida Foo.app # hooks.js: Interceptor.attach stubs nibkit segues Foo.app # navigation graph, container-aware nibkit segues --mermaid Foo.app # Mermaid flowchart (renders on GitHub in Markdown) nibkit all Foo.app # full report in one run nibkit -J segues Foo.app | jq '.[] | .navigation'
Tables size to the terminal width and long reports page through $PAGER
(set NIBKIT_PAGER=cat to disable). Piped output stays raw for grep and
jq. For raw strings just run strings -a on the nib files.
== Repository layout
[cols="2,5"]
|===
|main.go
|CLI entry point: flags, dispatch, interactive menu
|internal/nib/
|format parsers (NIBArchive, keyedarchive/bplist), emitters, discovery
|internal/mcp/
|MCP server over stdio
|docs/format.adoc
|the on-disk nib formats, documented field by field
|internal/nib/*_test.go
|synthetic-nib builders and parser/emitter tests (no files lifted from apps)
|===
== Demo
Demo of wiring on a real app, legacy (pre-2012) class extraction, a Mermaid navigation graph, and a macOS system app:
image::demo.gif[demo]
== Format support
[cols="3,2,5"] |=== |Input |Status |Notes
|.nib, .storyboardc (NIBArchive) |supported |coder versions 9, 10, and 11; verified on apps from 2019 through current macOS 26 / iOS 27, including macOS system apps
|.app bundles, directories |supported |walked recursively
|.ipa |supported |extracted automatically
|pre-2012 nibs (binary plist / NSKeyedArchive)
|supported |iOS (UINibObjectsKey) and macOS (IB.objectdata) nibs from the keyedarchive era decode through the same commands: outlets, actions, bindings, runtime attributes
|===
== Contact
Questions, bugs, broken files: open an issue, or reach me at https://t.me/keybleed[t.me/keybleed].
== Build
[source,sh]
go build -trimpath -ldflags="-s -w" -o nibkit . # ~2.4 MB static binary
cross-compile: GOOS/GOARCH (darwin/linux, arm64/amd64)
== License
MIT. See link:LICENSE[LICENSE].