OpenParable
Skip to content
← Back to skills

Update Dependency

Development
update-dependency

Update Dependency is an Agent Skill for development published in the dart-lang/sdk repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Updates third party dependencies in the Dart SDK

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/dart-lang/sdk/blob/HEAD/.agents/skills/update_dependency/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/update-dependency, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Instructions

Use this skill to update dependencies in the Dart SDK's DEPS file to their latest (or a specific) version. This tool automates the process of updating the version, syncing dependencies, updating package configurations, and creating a CL.

Prerequisites

Before running the tool, ensure your environment is prepared correctly:

  1. Clean Git State: Your git checkout MUST be clean. No uncommitted changes should be present.
  2. On Main Branch: You MUST be on the main branch. The tool creates a new branch from your current HEAD, so being on main ensures the bump starts from a clean baseline.

Tool Usage

Run the tools/manage_deps.dart script with the bump command from the root of the SDK.

Command Syntax

dart tools/manage_deps.dart bump <path/to/dependency> \
  [--branch <branch_name>] [--target <ref>]

Arguments

  1. <path/to/dependency> (required): The path to the dependency directory relative to the SDK root. Dependencies are entire repositories and not packages, so the path will usually be third_party/pkg/<repo>.
    • CRITICAL: DO NOT include a trailing slash in the path.
    • If unsure of the repository, you can look at the .dart_tool/package_config.json file relative to the SDK root, and search for "name": "<package-name>". Next to that you should see a "rootUri" key which will give you the path to the dependency. Do not use the full path though, just the top level directory under third_party/pkg/<repo>, since entire repos are always rolled at once.
    • If the .dart_tool/package_config.json file does not exist, it can be generated by running gclient sync.
  2. --branch <branch_name> (optional): The name of the branch to create for this update. Defaults to bump_<dependency_name>.
  3. --target <ref> (optional): The specific git ref (SHA, tag, branch) to update to. Defaults to the latest version on the remote's default branch.

Example

To bump the unified_analytics dependency, which is a part of the tools repo:

dart tools/manage_deps.dart bump third_party/pkg/tools

Troubleshooting

  • "Already at - nothing to do": The dependency is already at the latest version or the specified target.
  • Branch already exists: If the tool says a branch with the target name already exists, you will be prompted to delete it. Usually, it is safe to say "y" if you want a fresh bump.
  • "CorpSSO login required. To log in, run glogin or gcert": This indicates a Google-internal SSO authentication failure during fetching/syncing dependencies. This error and the suggested fix (gcert / glogin) are only applicable for Googlers. Since this requires interactive authentication, you must ask the user to run gcert (or glogin) in their terminal to authenticate, and then retry.