Stabilize cargo-script

[nikomatsakis]

Metadata
Point of contact	@epage
Team(s)	cargo, compiler, lang, rustdoc
Goal document	2026/cargo-script

Summary

Stabilize support for "cargo script", the ability to have a single file that contains both Rust code and a Cargo.toml.

Tasks and status

---

Note: we have updated the body to match the 2026 goal. Your original text is preserved below.

Details

Metadata
Point of contact	@epage
Team(s)	cargo, compiler, lang, lang-docs
Goal document	2025h2/cargo-script

Summary

Stabilize support for "cargo script", the ability to have a single file that contains both Rust code and a Cargo.toml.

Tasks and status

• Discussion and moral support (cargo, compiler )
• Ensure Cargo implementation (@epage)

Implement language feature frontmatter

• Rust-analyzer implementation (@epage)
• rustfmt implementation (@epage)
• Standard reviews (compiler )
• Author call for testing blog post (@epage)

Stabilize language feature frontmatter

• Author Reference PR (@epage)
• Review/revise Reference PR (lang-docs )
• Author stabilization report (@epage)
• Author stabilization PR (@epage)
• Stabilization decision (lang )

---

Note: we have updated the body to match the 2025h2 goal. Your original text is preserved below.

Metadata
Owner(s)	@epage
Team(s)	cargo, lang
Goal document	2024h2/cargo-script
See also	rust-lang/cargo#12207

Summary

Stablize support for "cargo script", the ability to have a single file that contains both Rust code and a Cargo.toml.

Tasks and status

See rust-lang/cargo#12207

[nikomatsakis]

This issue is intended for status updates only.

For general questions or comments, please contact the owner(s) directly.

[epage]

Key developments: What has happened since the last time. It's perfectly ok to list "nothing" if that's the truth, we know people get busy.

• None

Blockers: List any Rust teams you are waiting on and what you are waiting for.

• Time. Expectation is to get to this in a couple months

Help wanted: Are there places where you are looking for contribution or feedback from the broader community?

• rustc parser for code fence syntax
• see also Tracking Issue for cargo-script RFC 3424 cargo#12207

[epage]

No change since the last update.

[epage]

Key developments: What has happened since the last time. It's perfectly ok to list "nothing" if that's the truth, we know people get busy.

• feat: add CARGO_MANIFEST_PATH env variable cargo#14404
• feat(toml): Add autolib cargo#14591

Blockers: List any Rust teams you are waiting on and what you are waiting for.

• Time. Expectation is to get to this in a couple weeks

Help wanted: Are there places where you are looking for contribution or feedback from the broader community?

• rustc parser for code fence syntax
• see also Tracking Issue for cargo-script RFC 3424 cargo#12207

[epage]

Key developments: What has happened since the last time. It's perfectly ok to list "nothing" if that's the truth, we know people get busy.

• Remove the support for Cargo.toml of the cargo-script cargo#14670: posted and merged
• Change config paths to only check CARGO_HOME for cargo-script cargo#14749: posted and merged
• fix(toml): Update frontmatter parser for RFC 3503 cargo#14792: posted

Blockers: List any Rust teams you are waiting on and what you are waiting for.

• None

Help wanted: Are there places where you are looking for contribution or feedback from the broader community?

• Writing frontmatter support in rustc. rustfmt folks are asking for it to be represented in the AST.

[epage]

Key developments: What has happened since the last time. It's perfectly ok to list "nothing" if that's the truth, we know people get busy.

• fix(script): Don't override the release profile cargo#14925 posted and merged

Blockers: List any Rust teams you are waiting on and what you are waiting for.

• None

Help wanted: Are there places where you are looking for contribution or feedback from the broader community?

• Writing frontmatter support in rustc. rustfmt folks are asking for it to be represented in the AST.