Introducing Magic Device 0.0.2

Know when it is safe to run the heavy job.

Whether the device is on mains power, whether the viewer is away and whether the macOS window is fullscreen. One import, no setup, no Runner edits.

Get started View on pub.dev

~/my_app

$ flutter pub add magic_device

✓ battery_plus and flutter_inactive_timer resolved

import 'package:magic_device/magic_device.dart';

✓ DevicePower ready, nothing runs until start()

One import. Three signals.

Run the heavy job only when nobody will notice. Magic Device reads mains power, viewer idle and window fullscreen behind one small API.

Mains power

charging is true on mains power, read through battery_plus. A platform without an implementation answers false.
Learn more about Mains power
Viewer idle

macOS and Windows read the system input clock and report away after two minutes without input. Everywhere else it follows the app lifecycle.
Learn more about Viewer idle
Window fullscreen

Follow the macOS window as it changes and flip it with one toggle() call.
Learn more about Window fullscreen
Honest on every platform

A native read where one exists, a clear fallback where it does not. Its only native code is a macOS plugin.
Learn more about Honest on every platform
Idle until you start it

Nothing is collected until start(): an instance that never starts holds no channel, no timer and no lifecycle observer.
Learn more about Idle until you start it
Test without a device

Every DevicePower read except the app lifecycle is a constructor parameter, so a test needs no mocking library.
Learn more about Test without a device

Your agent speaks Magic Device.

The Magic Device skill teaches your coding assistant when to gate background work and how to wire DevicePower and WindowFullscreen before the first line. One command wires it up.

npx skills add anilcancakir/ai --skill magic-device

run in your project other editors

works with

Claude Code
Cursor
OpenCode
VS Code Copilot
Codex CLI

✻ claude ~/my_app connected

$ npx skills add anilcancakir/ai --skill magic-device

✓ magic-device installed

› run the sync only while the device is charging and idle

● Skill(magic-device) loaded

⏺ Edit lib/sync/sync_scheduler.dart

+ await power.charging && power.idle

✓ gated on mains power and idle

And checks the docs.

Skills teach the API. The MCP server at mcp.anilcancakir.com/magic_device gives your agent live docs lookup while it edits, so it never guesses a signature.

Streamable HTTP

One endpoint, every client.
search-docs

Live query against the source.
Public, no auth

Read-only, free to use.

Connect your editor

mcp.anilcancakir.com/magic_device preview

# streamable http, the default

claude
                        mcp add
                                                    --transport http
                            magic_device
                            https://mcp.anilcancakir.com/magic_device

# or stdio, for clients without http

npx
                            -y mcp-remote https://mcp.anilcancakir.com/magic_device

Public, no auth.

Add it in seconds

~/my_app

flutter pub add
                magic_device

Or add to pubspec.yaml:

dependencies:
  magic_device: ^0.0.2

Or give your AI agent this prompt:

Read   https://anilcancakir.com/magic_device/docs/llms.txt   and   install   the   Magic   Device   package   in   this   project.

Docs
AI

Know when it is safe to run the heavy job.

One import. Three signals.

Mains power

Viewer idle

Window fullscreen

Honest on every platform

Idle until you start it

Test without a device

Your agent speaks Magic Device.

And checks the docs.

Streamable HTTP

search-docs

Public, no auth

Add it in seconds