Necto

English | 한국어

Necto is an iOS debugging platform that connects anywhere.
Build the tools you need as plugins. A modern alternative to Flipper.

• Connect to an app on a USB device or an iOS simulator. The SDK listens inside your app, so there is no proxy to configure and no certificate to trust (docs/setup.md).
• Anything you need for iOS development can be a plugin. A device plugin rides in your app and its panel appears in Necto when the app connects; a desktop plugin installs from a GitHub release, folder or ZIP and works without a connected app (docs/plugin-manifest.md).
• Everything Necto does, the CLI does too. Install and delete plugins, call bridge operations, or install the bundled skill and let an AI debug the app itself (docs/control-socket.md).
• Feature screens are web plugins made up of a manifest.json and web assets. They use the same design tokens as the app (docs/design.md).
• The Mac app and SDK use Swift, while plugin screens use web technologies. The Mac app manages connections and execution without a separate server process (docs/architecture.md).

Getting started

Download the DMG from Releases and drag Necto into Applications. See the installation guide for checksum verification and the app's ad-hoc signing policy.

Building from source requires macOS 14 or later, Xcode with Swift 6.0 or later, Node.js 22.12 or later and Yarn 4.6.0. The iOS SDK supports iOS 16 or later.

script/build   # web packages, Swift packages, then the app
script/test    # unit tests and static checks
open Build/Products/Debug/Necto.app

After building the web packages, you can also open Necto.xcodeproj and run the Necto scheme. To build ExampleApp with script/build, start an iOS simulator before running the script.

To integrate the SDK into your app and exclude SDK calls from Release builds, see docs/setup.md.

Create a plugin

Requires Node.js 20+ and npm. Uses the latest release.

curl -fsSL https://raw.githubusercontent.com/toss/necto/main/script/create-plugin | bash -s -- Example --type device

Replace Example with your project name. --type: device or desktop.

Documentation

• Plugin tutorials: desktop · device
• Plugin specification: manifest · IDs and trust
• Bridge reference: available operations · web API · shell access
• CLI usage
• Contributor guides: architecture · design · verification

Contributing

Anyone is welcome to contribute. Read CONTRIBUTING.md (한국어) for how to report an issue and open a pull request.

License

MIT © Viva Republica, Inc. See LICENSE for details.