Agent skill

Restart App iOS Engine Restart

by gabrimatic in gabrimatic/restart_app

Configure or debug restartapp Flutter engine restart on iOS, including AppDelegate and UIScene registration, custom native shells, engine factories, and explicit notification fallback.

MITAuto-check passedMobile

Install Restart App iOS Engine Restart

skills CLI
$ npx skills add gabrimatic/restart_app --skill restart-app-ios-engine-restart -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gabrimatic/restart_app restart-app-ios-engine-restart --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gabrimatic/restart_app.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/restart-app-ios-engine-restart .claude/skills/restart-app-ios-engine-restart && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
restart-app-ios-engine-restart
GitHub stars
129
Token cost
~1.1k tokens
SKILL.md length
506 words
Files
2 (incl. references)
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Configure or debug restartapp Flutter engine restart on iOS, including AppDelegate and UIScene registration, custom native shells, engine factories, and explicit notification fallback.

  • Tasks that involve Cross-platform mobile apps
  • SKILL.md covers AppDelegate setup, Restart behavior, Failure handling and Notification fallback, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Restart App iOS Engine Restart is an agent skill from gabrimatic/restart_app. Configure or debug restartapp Flutter engine restart on iOS, including AppDelegate and UIScene registration, custom native shells, engine factories, and explicit notification fallback.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/host-setup.md`).

It sits in Mobile, covering Cross-platform mobile apps. It works with iOS, Flutter and Dart. The repository describes itself as: A Flutter plugin to restart or relaunch Flutter apps with platform-specific behavior, including opt-in iOS Flutter engine restart. The licence is MIT.

When your agent uses it

  • Tasks that involve Cross-platform mobile apps

Example prompts

  • “/restart-app-ios-engine-restart”

What it can do on your machine

Read from SKILL.md and the folder at commit e9f6582. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Restart App iOS Engine Restart loads about 1.1k tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 54 tokens; SKILL.md has 506 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from gabrimatic/restart_app at commit e9f6582, republished under its MIT licence (© gabrimatic). 506 words, ~1,114 tokens.

Download SKILL.mdSave it as .claude/skills/restart-app-ios-engine-restart/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
restart-app-ios-engine-restart
description
Configure or debug restart_app Flutter engine restart on iOS, including AppDelegate and UIScene registration, custom native shells, engine factories, and explicit notification fallback.

iOS Flutter engine restart

AppDelegate setup

Inspect the app's existing AppDelegate.swift, scene lifecycle, and engine ownership before editing them. Preserve existing plugin and lifecycle wiring. Read the AppDelegate examples for the matching lifecycle:

  • UIScene with FlutterImplicitEngineDelegate: retain registration of the initial engine in didInitializeImplicitFlutterEngine and configure registration of replacement engines separately.
  • Classic FlutterAppDelegate: retain normal initial registration in application(_:didFinishLaunchingWithOptions:) and add the replacement engine callback.
  • Custom engine or add-to-app: use setEngineFactory only when the host owns engine creation, startup, and plugin registration. The package example uses the standard UIScene setup; custom hosts must preserve their own ownership.

RestartAppPlugin.configureEngineRestart is a Swift API, not a Dart method. Rebuild the iOS app after editing AppDelegate; hot reload does not apply native changes. Xcode 27 requires UIScene lifecycle adoption. Updating only the restart callback does not migrate the host.

Restart behavior

  • Restart.restartApp() uses the configured engine path on iOS. Explicit RestartMode.flutterEngine selects the same path. Missing configuration returns IOS_ENGINE_RESTART_NOT_CONFIGURED; it never falls back implicitly.
  • RestartMode.process fails with IOS_PROCESS_RESTART_UNSUPPORTED. forceKill has no iOS effect. Do not propose private APIs or an exit/relaunch trick to implement automatic process restart.
  • Engine restart creates a new engine, runs Dart, registers plugins, replaces the Flutter view controller, and destroys the old engine context. The iOS process, native globals/singletons, unrelated engines, and native resources retained by plugins can survive. Do not promise code-push compatibility or native-state reset without testing that integration.
  • Save any unsaved changes the app needs to keep before restarting. Request restart on the main isolate while the app is active. A successful RestartResult acknowledges scheduling; factory or swap failures after that response are logged natively and cannot change the returned result.
Show full SKILL.md (231 more words)Show less

Failure handling

Result codeAction
IOS_ENGINE_RESTART_NOT_CONFIGUREDConfigure AppDelegate, rebuild, and check capability again.
IOS_APP_NOT_ACTIVEWait for foreground activation and an intentional restart action.
IOS_NO_ACTIVE_WINDOWCheck scene/window lifecycle or supply the correct windowProvider.
IOS_UNSAFE_ROOT_REPLACEMENTSupply a host-specific viewControllerInstaller; do not overwrite a native shell with a generic Flutter root.
IOS_RESTART_ALREADY_IN_PROGRESSPrevent duplicate restart requests.
IOS_PROCESS_RESTART_UNSUPPORTEDUse configured engine restart if it meets the requested behavior.

For a custom shell, select the intended scene explicitly. The default installer expects a FlutterViewController at the window root. beforeRestart runs before replacement engine creation; afterRestart runs after installation and before the old engine is destroyed. Keep app-specific cleanup consistent with that order.

Notification fallback

RestartMode.notificationFallback requests notification permission, schedules a local notification, and closes the app. The user must tap the notification to reopen it. Select this mode only when that interaction is intended. notificationFallback capability does not mean permission is granted. Handle NOTIFICATION_DENIED, AUTHORIZATION_ERROR, and NOTIFICATION_FAILED as failed results. Custom title/body alone do not select this mode. The plugin uses local notifications and needs no push entitlement.

Verification

Check capability after the host is configured, then test default and explicit engine restart in the foreground. Confirm a fresh Dart boot, saved data, working plugin calls/platform views, and a second successful restart. Inspect native logs if success is returned but the old UI remains. Verify native state assumptions and code-push behavior in a real release build.

© gabrimatic, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/restart-app-ios-engine-restart of gabrimatic/restart_app.

  • SKILL.md
  • references/host-setup.md

Open the folder on GitHubat commit e9f6582

Compare with similar skills

Restart App iOS Engine Restart next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Restart App iOS Engine Restart compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Restart App iOS Engine Restart this skillgabrimatic/restart_app129—~1.1kAutomated safety check: PassMIT
Engine Whats Newflutter/flutter180k—~978Automated safety check: PassBSD-3-Clause
Run Devicelab With Ledflutter/flutter180k—~852Automated safety check: PassBSD-3-Clause
Liquid Glass Widgetssdegenaar/liquid_glass_widgets730—~4.1kAutomated safety check: PassMIT
flutter_soloud Setupalnitak/flutter_soloud425—~3.6kAutomated safety check: NotesMIT
Flutter Appccplugins/awesome-claude-code-plugins970—~1.1kAutomated safety check: NotesApache-2.0

Similar skills

  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    180k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • Run Devicelab With Led

    flutter/flutter

    Run DeviceLab tests for Flutter PRs using LUCI's led CLI tool.

    180k GitHub stars~852 tokensUpdated today
    MobileAuto-check passed
  • Liquid Glass Widgets

    sdegenaar/liquid_glass_widgets

    Mastery guide and architectural rules for liquidglasswidgets.

    730 GitHub stars~4.1k tokensUpdated yesterday
    MobileAuto-check passed
  • flutter_soloud Setup

    alnitak/flutter_soloud

    Walks through adding the flutter_soloud audio engine to a Flutter app, with per-platform setup, initialization, binary-size and logging options, and output device switching.

    425 GitHub stars~3.6k tokensUpdated yesterday
    MobileAuto-check: notes
  • Flutter App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Flutter mobile app with clean architecture, Riverpod, FVM-pinned SDK, current packages, and no deprecated APIs.

    970 GitHub stars~1.1k tokensUpdated 1 mo ago
    MobileAuto-check: notes
  • Fkit Setup

    Joker-x-dev/FlutterKit

    将 FlutterKit 脚手架初始化为新的应用项目,统一修改应用显示名称、Dart 包名、Android Application ID、Apple Bundle ID、Linux/Windows 标识、Web 名称、运行时品牌文案、Logo、桌面图标和启动页。用户拉取模板后要求改名、改包名、替换品牌资源或完成首次项目配置时使用。

    127 GitHub stars~720 tokensUpdated 2 mo ago
    MobileAuto-check passed

More from gabrimatic/restart_app

  • Restart App Integration

    gabrimatic/restart_app

    Integrate or troubleshoot Flutter app restarts with restartapp, including restart modes, results, saved data, web routes, desktop relaunches, and requests from background isolates.

    129 GitHub stars~1.5k tokensUpdated 17 days ago
    Auto-check passed

Works with

Categories

Questions about Restart App iOS Engine Restart

What does Restart App iOS Engine Restart do?

Configure or debug restartapp Flutter engine restart on iOS, including AppDelegate and UIScene registration, custom native shells, engine factories, and explicit notification fallback. Restart App iOS Engine Restart is an agent skill from gabrimatic/restart_app. Configure or debug restartapp Flutter engine restart on iOS, including AppDelegate and UIScene registration, custom native shells, engine factories, and explicit notification fallback.

When should I use Restart App iOS Engine Restart?

Restart App iOS Engine Restart fits situations like: tasks that involve Cross-platform mobile apps.

How do I install Restart App iOS Engine Restart in Claude Code?

Run `npx skills add gabrimatic/restart_app --skill restart-app-ios-engine-restart -a claude-code`. Or copy the skill folder (skills/restart-app-ios-engine-restart in gabrimatic/restart_app) into .claude/skills/restart-app-ios-engine-restart in your project. Claude Code loads it when a task matches its description.

How do I install Restart App iOS Engine Restart in Codex?

Run `npx skills add gabrimatic/restart_app --skill restart-app-ios-engine-restart -a codex`. Or copy the skill folder (skills/restart-app-ios-engine-restart in gabrimatic/restart_app) into .agents/skills/restart-app-ios-engine-restart in your project. Codex loads it when a task matches its description.

Can I use Restart App iOS Engine Restart in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gabrimatic/restart_app --skill restart-app-ios-engine-restart -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/restart-app-ios-engine-restart, .gemini/skills/restart-app-ios-engine-restart, .github/skills/restart-app-ios-engine-restart and .opencode/skills/restart-app-ios-engine-restart in your project.

What does Restart App iOS Engine Restart need to run?

SKILL.md names no scripts, command-line tools or credentials: Restart App iOS Engine Restart is instructions for the agent only.

Does Restart App iOS Engine Restart access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Restart App iOS Engine Restart safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Restart App iOS Engine Restart use?

Restart App iOS Engine Restart is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Restart App iOS Engine Restart use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.1k tokens, read only when the agent opens those files.

What are the alternatives to Restart App iOS Engine Restart?

Skills that share tags, products or a category with Restart App iOS Engine Restart: Engine Whats New (flutter/flutter, 180k stars), Run Devicelab With Led (flutter/flutter, 180k stars), Liquid Glass Widgets (sdegenaar/liquid_glass_widgets, 730 stars) and flutter_soloud Setup (alnitak/flutter_soloud, 425 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Restart App iOS Engine Restart?

gabrimatic (a GitHub user) maintains it in gabrimatic/restart_app, which has 129 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 23, 2026.

Source: gabrimatic/restart_app on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.