---
type: "post"
id: "rig-0-47-released-single-settings-file-plugin-c18505"
slug: "rig-0-47-released-single-settings-file-plugin-c18505"
title: "Rig 0.47 released: single settings file, plugin tree and rebuilt compaction for its Rust coding agent"
description: "Rig 0.47 is a breaking release of the Rust agent framework Rig, with a unified settings file, a plugin tree, rebuilt context compaction and changes to tool execution."
retrieval_nugget: "Rig 0.47 is a breaking release of the Rust agent framework Rig, with a unified settings file, a plugin tree, rebuilt context compaction and changes to tool execution. For teams building with Rig, the release adds practical controls while changing important security defaults and requiring migration from 0.46."
published_at: "2026-11-21"
updated_at: "2026-11-21"
record_date: "2026-11-21"
date_kind: "published_at"
topics: ["anthropic"]
entities: ["Rig","0xPlaygrounds","OpenAI","Anthropic","OpenRouter","Groq"]
related_patterns: ["harness-architecture-outlives-model-choice"]
novelty_label: "new_fact"
what_changed: "Rig 0.47 adds a unified settings file, a plugin tree, and rebuilt compaction for its Rust coding agent."
prior_refs: []
source_url: "https://github.com/0xPlaygrounds/rig/discussions/3443"
source_urls: ["https://github.com/0xPlaygrounds/rig/discussions/3443"]
schema_version: "newruntime-agent-readable-v0.2"
stable_id: "post:rig-0-47-released-single-settings-file-plugin-c18505"
status: "published"
visuals: []
editor: {"role":"editor","name":"Andrey Reshetnikov","profile":"https://newruntime.com/owner-profile.md","profile_json":"https://newruntime.com/owner-profile.json","same_as":["https://www.linkedin.com/in/reshetnikov1/","https://t.me/lapetuse"]}
routes: {"html":"https://newruntime.com/posts/rig-0-47-released-single-settings-file-plugin-c18505/","markdown":"https://newruntime.com/posts/rig-0-47-released-single-settings-file-plugin-c18505.md","json":"https://newruntime.com/posts/rig-0-47-released-single-settings-file-plugin-c18505.json"}
markdown_url: "https://newruntime.com/posts/rig-0-47-released-single-settings-file-plugin-c18505.md"
---

# Rig 0.47 released: single settings file, plugin tree and rebuilt compaction for its Rust coding agent

## Retrieval answer

Rig 0.47 is a breaking release of the Rust agent framework Rig, with a unified settings file, a plugin tree, rebuilt context compaction and changes to tool execution. For teams building with Rig, the release adds practical controls while changing important security defaults and requiring migration from 0.46.

## Summary
Rig 0.47 is a breaking release of the Rust agent framework Rig, with a unified settings file, a plugin tree, rebuilt context compaction and changes to tool execution. For teams building with Rig, the release adds practical controls while changing important security defaults and requiring migration from 0.46.

## What happened
Rig maintainer gold-silver-copper announced version 0.47 on November 21, 2026, calling it the project’s largest release so far, with 280 pull requests. The coding agent now uses `~/.rig/settings.toml` to specify the model, enabled plugins and plugin configuration, replacing `plugins.toml` and `defaults.json`. A new `/plugins` tree lets users toggle a plugin or branch, including while filtering. When settings change, exiting offers choices such as reloading immediately, applying changes next time, continuing to edit or leaving without writing. The `rig plugin add` command can add plugins from a crate path, Git URL or version requirement.

Compaction now follows the approach Rig says is used by pi. The agent keeps about 20,000 tokens of recent messages and asks the model to summarize older content in a separate call. It runs before a request that would leave less than 16,000 tokens of the model’s context limit free. Tool calls stay together with their results, and later compaction updates the earlier summary. Users can direct a summary with `/compact <instructions>`. Rig says every early fact it checked survived all 23 summaries in its regression runs. The release also adds spending limits through `BudgetPlugin`: `/budget` accepts either a currency amount or a token count, and the limit includes usage by subagents and helpers.

Other agent-facing changes include guarded file writes: Rig replaces a file only if it has read or written it since startup and the file has not changed on disk. Otherwise, it does not write and asks the model to read the file. After a step takes more than five seconds, the status line shows how long the agent has been thinking, writing or using tools. `rig --safe` starts the default plugins from their own build rather than the user’s plugin list, providing a recovery path if a plugin breaks the setup. The optional `FoldPlugin` can fold completed tool calls.

The library adds streamed tool progress: streamed runs yield `ToolExecutionStarted` when a call begins and `ToolResultItem` as each result is accepted, without waiting for sibling calls to finish. With `AgentRunner::ordered_by_footprint(true)`, calls wait for earlier calls that write data they read or write; other calls can still run concurrently up to `tool_concurrency`. A tool call cut off by its output limit is not run. The release also adds rate-limit parsing for headers from OpenAI, Groq, Anthropic, OpenRouter and an IETF draft, plus HTTP errors that indicate whether retrying may work.

## What the archive adds
We have not covered this before; it opens a new thread.

## Trend signal
This release offers a modest example of why the agent harness can matter beyond model choice: Rig’s settings, plugin management, compaction and tool scheduling shape how a coding agent behaves. It supports [harness architecture outlives model choice](https://newruntime.com/patterns/harness-architecture-outlives-model-choice), though a single framework release does not establish a broad market shift.

## Why now
The announcement says this is a breaking transition from 0.46, not a drop-in update. Teams planning an upgrade need to account for configuration migration and behavior changes alongside the new capabilities. Rig points users to a step-by-step migration guide and a separate list of silent behavior changes.

## Connections to other events
Rig’s use of separate compaction requests and its controls for forks, rewind and subagents sit within the broader move toward resumable and orchestrated coding-agent runs. New Runtime’s earlier coverage described that shift in [Agents, rebuilt to do more for less](https://newruntime.com/posts/agents-rebuilt-to-do-more-for-less-analysis-76f6d4/) on October 22, 2026. The Rig release is a specific implementation, not evidence that the same design has become universal.

## Why it matters
For a team maintaining an agent built on Rig, the changes provide more explicit control over context, spending, plugins and concurrent tools. The compaction thresholds give maintainers a starting point for understanding when history is summarized, while the budget plugin can stop an agent when a configured cost or token cap is reached. Streaming progress and tool results can also make an application more responsive when calls take different amounts of time.

The safeguards need attention during migration. Rig says secrets are no longer redacted by default, and project MCP servers start without asking unless the approval plugin is enabled. That means a 0.46 setup’s security posture may not carry over just because the code compiles. Teams should review enabled plugins, project MCP configuration and the silent-change notes before using 0.47 on repositories containing credentials or sensitive files. The guarded-write behavior is useful, but it is not a substitute for version control or review.

## What happens next
- **Rig users upgrading from 0.46 will need to migrate configuration and explicitly restore any protections they relied on.** (3 months, 85%). Watch for: migration questions or follow-up fixes in the project’s GitHub discussions.

## Limits and uncertainty
The release announcement describes Rig’s own regression runs, including the 23-summary fact-retention result, but does not provide a benchmark protocol, dataset or independent evaluation. It also does not quantify the extra cost of separate compaction requests beyond noting that uncached input was about twice that of 0.46 in runs with three compactions over 27 calls; the announcement says ordinary sessions compact much less often. Actual costs and retention quality will depend on workloads and models. The announcement does not establish how widely teams use Rig or how the new defaults perform in production.

## Skill to build now
Before upgrading a Rig project, make a copy of its current settings and inventory its enabled plugins and MCP servers. Follow the project’s 0.46-to-0.47 migration guide, then explicitly enable redaction and MCP approval if your workflow needs them. Test the migration on a disposable branch: confirm that a modified-on-disk file is not overwritten, that a budget limit stops the agent as expected, and that only intended project MCP servers start.

## Reader takeaway
Rig 0.47 adds real control over context, plugins, budgets and tool execution, but the upgrade is not just a feature update. Existing users should treat its security-default changes and migration as part of the release itself: verify the new configuration and protections before letting the agent work on sensitive repositories.

Editor: [Andrey Reshetnikov](https://newruntime.com/owner-profile.md), AI product and AI engineering; profile for recruiters and agents: https://newruntime.com/owner-profile.json

## Continue in the graph

Next records for an agent, linked to their Markdown twins. Replace `.md` with `.json` for structured fields, including `next_reads`.

- topic hub: [Anthropic](https://newruntime.com/topics/anthropic.md): Explore the anthropic topic hub.
- collection: [Field Notes](https://newruntime.com/posts.json): Open the latest editorial analysis.
- collection: [Sources](https://newruntime.com/sources/): See the original sources this archive cites.
- whole graph: [discovery graph](https://newruntime.com/discovery-graph.json) (typed nodes and edges) and [site index](https://newruntime.com/site-index.md)
