Skip to main content

AI-Assisted Setup

Let your AI coding assistant set up Ulinkly deep linking for you. One command installs everything, then the AI detects your project, configures your dashboard, edits local files, and verifies the setup — all interactively.

Quick Start​

npx skills add https://ulink.ly

This installs the Ulinkly onboarding skill via the open agent-skills CLI — supported by Claude Code, Cursor, Codex, OpenCode, and 50+ other AI coding tools. After install, open your assistant in your project directory and ask it to "setup ulink".

That's it. The AI handles the rest.

Don't drop the https://

The agent-skills CLI parses bare hostnames as GitHub shorthand. Always include https:// so it discovers the well-known endpoint at ulink.ly/.well-known/agent-skills/.

Alternative: install from GitHub​

npx skills add FlywheelStudio/ulink-ai-setup

Same skill, fetched from the canonical GitHub repo.

Alternative: legacy installer​

npx @ulinkly/setup

Older installer — limited to Claude Code, Cursor, and Antigravity. Prefer npx skills add https://ulink.ly above for broader agent support.

What Gets Installed​

The setup uses two pieces:

  1. Ulinkly MCP Server — gives your AI access to your Ulinkly account (projects, links, domains, analytics)
  2. Onboarding Skill — a guided workflow the AI follows to set up deep linking in your app

What each install path sets up:

  • npx skills add https://ulink.ly installs the skill only. When the skill starts, it checks for the MCP server and, if it isn't connected, shows you the command to add it for your tool. See MCP Server.
  • The Claude Code plugin and the legacy npx @ulinkly/setup installer set up both the MCP server and the skill.

What the AI Does​

Once installed, the AI walks you through seven phases:

PhaseWhat happens
PreflightVerifies MCP connection, installs CLI if needed
DetectScans your project to identify Flutter, iOS, Android, or React Native
ConnectLists your Ulinkly projects, creates one if needed
DomainHelps you pick or create a domain for your links
ConfigureCollects platform settings, pushes to dashboard, edits local files (with your confirmation)
VerifyRuns ulink verify and helps fix any issues
SummaryShows everything that was configured and next steps

Manual Setup by Platform​

If you prefer to set things up manually instead of using npx @ulinkly/setup:

Claude Code​

# Install the Ulinkly plugin (includes MCP server + onboarding skill)
claude plugin marketplace add FlywheelStudio/ulink-ai-setup
claude plugin install ulink-onboarding@ulink

Restart Claude Code, then run /ulink-onboarding:setup-ulink in your project (or ask Claude to set up Ulinkly deep linking).

Cursor​

1. Add MCP server — add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ulink": {
      "command": "npx",
      "args": ["-y", "@ulinkly/mcp-server@latest"]
    }
  }
}

2. Install skill — copy the skill to ~/.cursor/skills/setup-ulink/.

Restart Cursor, then ask the agent: "setup ulink" in your project.

Antigravity​

1. Add MCP server — add to ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "ulink": {
      "command": "npx",
      "args": ["-y", "@ulinkly/mcp-server@latest"]
    }
  }
}

2. Install skill — copy the skill to ~/.gemini/antigravity/skills/setup-ulink/.

Restart Antigravity, then ask the agent: "setup ulink" in your project.

Supported Platforms​

The onboarding skill supports:

  • Flutter — detects pubspec.yaml, configures both iOS and Android
  • iOS Native — detects Xcode projects, sets up Associated Domains and URL schemes
  • Android Native — detects Gradle projects, sets up App Links and intent filters
  • React Native / Expo — detects package.json + app.json, configures iOS and Android (Expo config plugin or manual native setup)

Ulinkly CLI​

The AI uses the Ulinkly CLI for verification. If Node.js is available, nothing needs to be installed; it runs:

npx -y @ulinkly/cli verify -v

If Node.js isn't available, the AI offers to install the native CLI:

curl -fsSL https://ulink.ly/install.sh | bash

MCP Server Only​

If you only need the MCP tools (without the guided onboarding), see the MCP Server page.