Update Dependency
Developmentupdate-dependencyUpdate 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
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
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:
- Clean Git State: Your git checkout MUST be clean. No uncommitted changes should be present.
- On Main Branch: You MUST be on the
mainbranch. The tool creates a new branch from your current HEAD, so being onmainensures 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
<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 bethird_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.jsonfile 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 underthird_party/pkg/<repo>, since entire repos are always rolled at once. - If the
.dart_tool/package_config.jsonfile does not exist, it can be generated by runninggclient sync.
--branch <branch_name>(optional): The name of the branch to create for this update. Defaults tobump_<dependency_name>.--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 rungcert(orglogin) in their terminal to authenticate, and then retry.