Agent skill

Restart App Integration

by gabrimatic in 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.

MITAuto-check passedMobile

Install Restart App Integration

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

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

GitHub CLI
$ gh skill install gabrimatic/restart_app restart-app-integration --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-integration .claude/skills/restart-app-integration && 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-integration
GitHub stars
129
Token cost
~1.5k tokens
SKILL.md length
726 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

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

  • Tasks that involve Cross-platform mobile apps
  • SKILL.md covers Basic usage, State and errors, Platform behavior and Web destinations, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Restart App Integration is an agent skill from 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.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Cross-platform mobile apps. It works with Flutter, Dart and iOS. 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-integration”

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 (its code samples are dart and cmake).

    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 Integration loads about 1.5k tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 726 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

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). 726 words, ~1,544 tokens.

Download SKILL.mdSave it as .claude/skills/restart-app-integration/SKILL.md (or your agent's skills folder).
name
restart-app-integration
description
Integrate or troubleshoot Flutter app restarts with restart_app, including restart modes, results, saved data, web routes, desktop relaunches, and requests from background isolates.

Flutter app restart integration

Basic usage

Import package:restart_app/restart_app.dart and call Restart.restartApp(). It returns Future<RestartResult>. There is no restart widget, initialization method, or Restart.restart() API.

Use the default mode unless the app needs a particular restart method. Check Restart.restartCapability() when presenting a choice of modes. Its flags report platform support; they do not guarantee that a restart will succeed. Web supports the default restart even though its three restart flags are false.

dart
import 'package:flutter/material.dart';
import 'package:restart_app/restart_app.dart';

Future<void> restartFromButton(BuildContext context) async {
  final result = await Restart.restartApp();
  if (!context.mounted || result.success) return;

  ScaffoldMessenger.of(context).showSnackBar(
    SnackBar(
      content: Text(result.message ?? result.code ?? 'Could not restart the app.'),
    ),
  );
}

State and errors

  • If the app has unsaved changes that must survive, finish saving them through its existing storage code before restarting. Follow that storage API's durability guarantees. A failed save must not trigger a restart.
  • A restart does not erase preferences, files, databases, or stored credentials. Do not rely on code after the restart call to finish essential work.
  • Read success, mode, code, and message. Success means the platform accepted the request. A later native failure can leave the old app running; inspect native logs when startup does not run again.
  • Platform errors return failed results. MISSING_PLUGIN means native registration is missing: fix registration and rebuild the app. If calling before runApp, initialize the Flutter binding before using the channel.
  • Disable repeated restart actions once a request starts. Keep them disabled after acceptance; allow another attempt if the request fails. Check context.mounted before updating UI after an await. Do not retry in a loop.
  • Overlapping requests return RESTART_ALREADY_IN_PROGRESS on Android and desktop, or IOS_RESTART_ALREADY_IN_PROGRESS on iOS. Wait for the existing request rather than switching modes.
  • Send background-worker requests to the main isolate through a SendPort/ReceivePort. Request iOS engine restart while the app is active.

Platform behavior

PlatformModesBehavior
AndroidplatformDefault, processDefault relaunches the main activity. process or forceKill: true also ends the old process. Requires an attached activity and launch intent; Android TV and Fire TV launcher entries are supported.
iOSplatformDefault, flutterEngine, notificationFallbackDefault and engine modes require AppDelegate configuration. Use the bundled restart-app-ios-engine-restart skill. Automatic full process restart is unavailable.
WebplatformDefaultReloads the whole Flutter web app at the same browser URL by default. webOrigin selects a different destination.
macOSplatformDefault, processOpens a new instance through NSWorkspace, then asks the old instance to quit. Both modes resolve to process.
LinuxplatformDefault, processReplaces the running program through execv while keeping its process ID. Both modes resolve to process.
WindowsplatformDefault, processOpens a new process through CreateProcessW and ends the old process. Preserves the command line. Both modes resolve to process.

Unsupported modes return a failure. forceKill only affects Android. Notification title and body only customize the explicit iOS notification mode; they do not select it. Never switch to notification fallback automatically when iOS engine setup is missing.

On macOS, a termination delegate can prevent the old instance from quitting. Windows MSIX/Store packaging can restrict standard process launching. Check restart behavior in the app's actual distribution format.

Show full SKILL.md (251 more words)Show less

Web destinations

Without webOrigin, or with an empty value, the full browser URL stays the same, including path, query, and hash. The Flutter app starts again; its router decides which screen to show. Restarting at /settings does not navigate to /.

  • A hash route such as #/home changes the fragment and reloads. It adds a browser history entry if the fragment changes.
  • Full and relative URLs replace the current history entry. If the destination is the same document, it still reloads, including when its fragment changes or is removed.
  • Relative URLs resolve against document.baseURI, including an HTML base element. / means the website root, not necessarily the Flutter app's root.

With path routing, verify that the server serves the app at the destination URL.

Linux arguments

To keep command-line arguments, edit the app's existing linux/runner/main.cc (linux/main.cc in older Flutter projects). Include <restart_app/restart_app_plugin.h> and call restart_app_plugin_store_argv(argc, argv) inside main, before starting Flutter. Keep the existing runner code.

Flutter's generated plugin rules link the runner to restart_app_plugin. For custom plugin wiring, ensure this link exists in linux/CMakeLists.txt, after include(flutter/generated_plugins.cmake):

cmake
target_link_libraries(${BINARY_NAME} PRIVATE restart_app_plugin)

Without this setup, the restarted app receives only the executable argument.

Verification

For Dart tests, mock MethodChannel('restart') and its restartApp and restartCapability methods. Check request options and error UI, then clear the mock handlers. Run the app separately to verify actual restarts.

Save a launch marker, request a restart, and confirm that startup runs again, saved data remains, and temporary Dart state resets. On iOS, also check plugin calls and platform views after repeated engine restarts.

© 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

Just SKILL.md in skills/restart-app-integration of gabrimatic/restart_app.

Open the folder on GitHubat commit e9f6582

Compare with similar skills

Restart App Integration 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 Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Restart App Integration this skillgabrimatic/restart_app129—~1.5kAutomated safety check: PassMIT
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
Run Devicelab With Ledflutter/flutter179k—~852Automated safety check: PassBSD-3-Clause
Liquid Glass Widgetssdegenaar/liquid_glass_widgets725—~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).

    179k 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.

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

    sdegenaar/liquid_glass_widgets

    Mastery guide and architectural rules for liquidglasswidgets.

    725 GitHub stars~4.1k tokensUpdated today
    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 iOS Engine Restart

    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.

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

Works with

Categories

Questions about Restart App Integration

What does Restart App Integration do?

Integrate or troubleshoot Flutter app restarts with restartapp, including restart modes, results, saved data, web routes, desktop relaunches, and requests from background isolates. Restart App Integration is an agent skill from 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.

When should I use Restart App Integration?

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

How do I install Restart App Integration in Claude Code?

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

How do I install Restart App Integration in Codex?

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

Can I use Restart App Integration 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-integration -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-integration, .gemini/skills/restart-app-integration, .github/skills/restart-app-integration and .opencode/skills/restart-app-integration in your project.

What does Restart App Integration need to run?

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

Does Restart App Integration 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 Integration 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 Integration use?

Restart App Integration 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 Integration use?

About 1.5k tokens (SKILL.md is roughly 6.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Restart App Integration?

Skills that share tags, products or a category with Restart App Integration: Engine Whats New (flutter/flutter, 179k stars), Run Devicelab With Led (flutter/flutter, 179k stars), Liquid Glass Widgets (sdegenaar/liquid_glass_widgets, 725 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 Integration?

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.