Skip to main content
plugin

slipstream — Claude Code plugin: what it does, how to install

slipstream connects Claude Code to running Flutter apps for live UI inspection, screenshots, semantics interaction, and clean Dart API stubs.

BSD-3-Clause ★ 5 updated 2026-08-17

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install slipstream@claude-community
Open on GitHub

What slipstream does

Slipstream provides Claude Code with real-time insight into Flutter desktop builds. The agent triggers desktop runs using run_app, applies hot reload on file edits, and captures screenshots directly. It detects layout overflows and widget rendering glitches on its own, cutting out manual back-and-forth descriptions.

The plugin packages two toolsets and one automated skill. The inspector tools handle widget queries, clicks, text input, and Dart expression evaluation on the main isolate. Meanwhile, the packages group generates concise API stubs straight from your local pub cache to avoid outdated signatures. The bundled add-package skill analyzes flutter pub add logs to intercept discontinued packages.

Basic semantics and inspector checks work right away. However, finder-based interactions, scroll actions, and route navigation fail unless you add package:slipstream_agent to your dependencies.

What it helps with

  • Inspect Flutter widget trees and catch layout overflows during live execution
  • Fetch exact public API signatures directly from the local Dart pub cache
  • Catch discontinued or outdated dependencies during flutter pub add
  • Trigger taps, typing, and scrolling without setting up test harnesses

Example prompts for the agent

  • Launch the Flutter app on desktop and verify there are no layout overflow warnings
  • Type [email protected] into the email field and tap the login button
  • Generate a Dart stub of the public classes for the local dio package

How to install slipstream

Plugin marketplace

/plugin marketplace add anthropics/claude-plugins-community
/plugin install slipstream@claude-community

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about slipstream

How to install slipstream in Claude Code?

Run /plugin marketplace add anthropics/claude-plugins-community in your session, then install it with /plugin install slipstream@claude-community.

What does slipstream do?

It grants the coding agent live introspection over a running Flutter application, enabling screenshots, hot reload, widget inspection, and dependency safety checks.

Is the slipstream_agent package required?

No, basic semantics and standard inspector protocols work out of the box. You only need package:slipstream_agent if you want finder-based taps, text entry, scrolling, and route tracking.

Source text

SKILL.md · BSD-3-Clause
![Flutter Slipstream in action](docs/slipstream_banner.png)

# Flutter Slipstream

Flutter Slipstream is an agentic plugin that makes AI coding agents more
effective for Dart and Flutter projects. It enables live app introspection for
Flutter apps: screenshots, widget-tree inspection, tap/type/scroll interaction,
and error capture, as well as Dart package API summarization for agents.

This addresses two structural problems that agents face:

- a lack of runtime visibility into a running Flutter app — agents can't see
  screenshots, inspect the widget tree, or verify that a state change took
  effect
- training cutoffs that leads to stale package choices and subtly wrong API
  signatures

## Features

- **Live app inspection** — launch a Flutter app, take screenshots, inspect the
  widget tree, evaluate Dart expressions, and observe runtime errors, all from
  agent tool calls.
- **Tap, type, and scroll** — interact with the running app via semantics or
  widget finders; no test harness required.
- **Accurate package APIs** — retrieve any package's public API directly from
  the local pub cache as a compact Dart stub, version-matched and free of
  implementation noise.
- **Package safety guidance** — the bundled skill instructs agents to read pub
  command output for discontinued packages and outdated major versions, and take
  corrective action before bad dependencies land.

## Installation

| Coding Agent   | Installing Slipstream                                                                                              |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| Claude Code \* | `claude plugin marketplace add devoncarew/slipstream` <br> `claude plugin install flutter-slipstream@slipstream`   |
| GitHub Copilot | `copilot plugin marketplace add devoncarew/slipstream` <br> `copilot plugin install flutter-slipstream@slipstream` |
| Gemini CLI     | `gemini extensions install https://github.com/devoncarew/flutter-slipstream`                                       |

> [!NOTE]
>
> If you see a "Failed to install plugin ... No ED25519 host key is known for
> github.com ... Host key verification failed" error, see
> anthropics/claude-code/issues/26588 / anthropics/claude-code/issues/50725 for
> possible workarounds.

## Getting Started / Using Slipstream

Install the plugin, then work on Flutter projects as you normally would. No
special prompting is required — Slipstream works in the background.

**UI development workflow:** When building or debugging UI, ask the agent to run
the app. It will launch on a desktop device automatically, then iterate using
hot reload after each source edit. Because the agent can take screenshots and
inspect the widget tree, it catches overflow errors, layout surprises, and
rendering regressions on its own — without you having to describe what went
wrong.

**Package hygiene:** When an agent adds a package, the bundled skill guides it
to read `flutter pub add` output for discontinued-package and outdated-version
warnings, and to take corrective action (switching to the replacement package,
or updating the version constraint) before the bad dependency lands.

**Optional: richer instrumentation.** Add
[`package:slipstream_agent`](https://pub.dev/packages/slipstream_agent) as a
dependency for finder-based interactions (tap by key, type, or text), scroll
support, and router-aware navigation. Without it, Slipstream still works well
via semantics and the Flutter inspector protocol.

## Tools

### Flutter UI agent (`inspector`)

MCP commands for launching, inspecting, and interacting with a running Flutter
app. Gives agents a [Playwright](https://playwright.dev/)-style interface to the
running app: take screenshots, inspect the widget tree, evaluate arbitrary Dart
expressions, and observe runtime errors with widget IDs.

<!-- inspector -->
<!-- prettier-ignore-start -->
| Command | Description |
|---------|-------------|
| `run_app` | Builds and launches the Flutter app. |
| `reload` | Applies source file changes to a running Flutter app. |
| `get_output` | Returns buffered app output and runtime events since the last call (or the last reload/restart). |
| `take_screenshot` | Captures a PNG screenshot of the running Flutter app. |
| `inspect_layout` | Use when debugging layout issues, overflow errors, or unexpected widget sizing. |
| `evaluate` | Evaluates a Dart expression on the running app's main isolate and returns the result as a string. |
| `get_route` | Returns the current navigator route stack with screen widget names and source locations. |
| `navigate` | Navigates the app to a route path. |
| `perform_tap` | Taps a widget located by a finder. |
| `perform_set_text` | Sets the text content of a text field located by a finder. |
| `perform_scroll` | Scrolls a Scrollable widget by a fixed number of logical pixels. |
| `perform_scroll_until_visible` | Scrolls a Scrollable until a target widget is visible in the viewport. |
| `get_semantics` | Returns a flat list of visible semantics nodes from the running Flutter app. |
| `perform_semantic_action` | Dispatches a semantics action on a widget by semantics node ID or label. |
| `close_app` | Stops the running Flutter app and releases its session. |
<!-- prettier-ignore-end -->
<!-- inspector -->

### Package API retrieval (`packages`)

Retrieves a package's public API surface directly from the local pub cache and
returns it as a compact Dart stub — signatures only, no bodies, no private
members. Agents get accurate, version-matched API information without reading
raw source files or relying on training-data summaries.

<!-- packages -->
<!-- prettier-ignore-start -->
| Command | Description |
|---------|-------------|
| `package_summary` | Returns API summaries for Dart or Flutter packages; start here to orient on an unfamiliar package. |
| `library_stub` | Returns the full public API for one library as a Dart stub (signatures only, no bodies). |
| `class_stub` | Returns the public API for a single named class, mixin, or extension as a Dart stub (signatures only, no bodies). |
<!-- prettier-ignore-end -->
<!-- packages -->

### Package safety skill

The `add-package` skill fires automatically when an agent is about to add a Dart
or Flutter package dependency. It instructs the agent to:

- Use `flutter pub add` rather than editing `pubspec.yaml` directly, so pub
  output is always visible.
- Read `pub add` output for `(discontinued replaced by X)` annotations and
  switch to the replacement package.
- Read `pub add` output for `(X.Y.Z available)` annotations on newly added
  direct dependencies, and run `flutter pub outdated` to confirm a major-version
  gap before proceeding.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

© devoncarew · BSD-3-Clause · devoncarew/flutter-slipstream

Similar plugins

All plugins for Mobile →
flutter-add-widget-test flutter flutter-add-widget-test is a Claude Code skill for writing Flutter widget tests that check rendered UI and user actions. It activates when a specific widget needs validation. CX Codex +1 42,900installs flutter-fix-layout-issues flutter flutter-fix-layout-issues reads a Flutter layout exception and tells you what to wrap in what: overflow stripes, unbounded constraints, misplaced ParentData widgets. CX Codex +1 43,700installs flutter-testing Stanislav [MADTeacher] Chernyshev flutter-testing — a skill for writing, fixing and debugging Flutter tests: unit, widget and integration layers, mocks, golden checks. CX Codex +1 1,500installs flutter-networking Stanislav [MADTeacher] Chernyshev flutter-networking — a skill for Claude Code and five other agents that writes, fixes, and reviews networking code in Flutter apps. It handles HTTP/REST, WebSocket channels, token refresh, and JSON parsing inside your project. CX Codex +1 733installs flutter-expert Seth Hobson flutter-expert — a subagent for Claude Code, Codex, and Cursor focused on Flutter 3.x and Dart 3.x. Covers architecture, custom widgets, state management, and cross-platform builds for mobile, web, desktop, and embedded targets. CX Codex 720installs dart-run-static-analysis dart-lang dart-run-static-analysis runs dart analyze to catch errors and dart fix --apply to resolve mechanical linter issues. Helps verify Dart code quality during development and before commits. CX Codex +1 21,200installs

Project sponsors

Companies that keep this analytics open