Skip to content

docs(skill): let the agent run the app, and fix two CLI claims - #142

Merged
mateusz-pietras merged 1 commit into
mainfrom
docs/skill-uri-and-cli
Oct 25, 2026
Merged

mateusz-pietras merged 1 commit into
mainfrom
docs/skill-uri-and-cli

Conversation

@mateusz-pietras

Copy link
Copy Markdown
Member

Summary

Three fixes to marionette-flutter-drive-app/SKILL.md:

 ## Connecting
-… the developer running the app has it in their `flutter run` console output … Ask for it …
+Get it one of two ways:
+- The developer runs the app. … Ask for it.
+- You run the app. Start `flutter run` yourself … read `A Dart VM Service on … available at: http://…/`
+  and use it as `ws://…/ws`.

 ## CLI
-… maps onto it one-for-one …, plus `record-video` …
+… one-for-one …, except the app's custom extensions, which only the MCP server offers …
-pass `--session <title>` consistently across a script's invocations to log a multi-step run into one session directory
+every CLI invocation … writes its own session directory. `--session <title>` names that directory; it does not join invocations into one run
  • Agent-run app. The site's quick start now offers "ask the agent to run the app"; the skill only told the agent to ask for the URI.
  • --session. marionette_command_runner.dart documents it as "Every invocation gets its own fresh session directory, titled from this if given", and SessionManager suffixes a name that is already taken rather than reusing it. marionette help-ai already says so; the skill said the opposite.
  • Custom extensions. The CLI has no command for list_custom_extensions, call_custom_extension or the schema-named tools.

Evidence

Each statement checked against the code named above and the CLI's command list (packages/marionette_cli/lib/src/cli/commands/). flutter run --help has no option that writes the URI to a file, so the skill reads it from the output.

Merge Danger

Door: two-way.

Blast Radius: agents using the skill, from the next marionette_flutter release.

#138 edits the paragraph right after the --session one, so whichever of the two merges second gets a small text conflict there.

🤖 Generated with Claude Code

Connecting only told the agent to ask for the VM service URI. An agent
can also start `flutter run` itself and read the URI from its output,
and the skill now says how.

Two statements about the CLI did not match the code. `--session` names
the directory of one invocation; every invocation still gets its own
directory, so it never joins a multi-step run into one. And the app's
custom extensions have no CLI command, so the capability table does not
map onto the CLI one-for-one.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 22, 2026 17:18
@netlify

netlify Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for marionette-landing canceled.

Name Link
🔨 Latest commit 18e98cb
🔍 Latest deploy log https://app.netlify.com/projects/marionette-landing/deploys/6ada4573eb8e45c71a3db2a8

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing. Review the Copilot code review billing settings.

@mateusz-pietras
mateusz-pietras merged commit e7792b8 into main Oct 25, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants