Skip to main content

AI-Assisted Setup

Let your AI coding assistant set up ULink 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 ULink 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 command configures two things for your AI tool:

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

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, or Android
ConnectLists your ULink 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 ULink 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 /setup-ulink in your project.

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

The AI uses the ULink CLI for verification. If it's not installed, the AI will offer to install it for you:

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.