Skip to contents

btw 1.1.0

CRAN release: 2025-12-22

  • btw_client() now supports reading CLAUDE.md files as project context files. CLAUDE.md files are searched after AGENTS.md but before user-level btw.md. YAML frontmatter in CLAUDE.md files is stripped but not used for configuration (#146).

  • btw_app() now shows a rich diff view in the btw_tool_files_write_text_file() tool, if the diffviewer package is installed (#144).

  • btw() now correctly handles character matrices (#139).

  • btw_app() now correctly displays input tokens with ellmer v0.4.0. Previously, we were showing the total input tokens sent across all API calls, rather than the current number of input tokens as of the last API call. We now show the size of the input context window (i.e. the number of input tokens that will be used for the conversation history in the next API call). Note that token usage is dependent on the provider and model used and is only an estimate.

  • New “pkg” tool group with package development tools: btw_tool_pkg_document(), btw_tool_pkg_check(), btw_tool_pkg_test() and btw_tool_pkg_coverage() provide LLMs with the ability to document, check, test, and check test coverage of R packages during development (#133, #136).

  • New btw_tool_run_r() tool allows LLMs to run R code and to see the output, including of plots. Because this tool lets LLMs run R arbitrary R code in the global environment (which can be great but can also have security implications), it is opt-in and disabled by default. See ?btw_tool_run_r for more details (#126).

  • btw_tool_docs_help_page() now uses markdown headings and sections for argument descriptions, rather than a table. This is considerably more token efficient when the argument descriptions have more than one paragraph and can’t be converted into a markdown table (@jeanchristophe13v, #123).

  • btw now removes large inline base64-encoded images, replacing them with a placeholder containing the image’s alt text (@jeanchristophe13v, #119).

  • btw_app() now works correctly with ellmer v0.4.0 (#121).

  • btw_app() now shows more precise cost estimates when the cost is less than $0.10 (#121).

btw 1.0.0

CRAN release: 2025-11-04

  • Initial CRAN submission.