
Package index
- 
          
btw() - Plain-text descriptions of R objects
 
- 
          
btw_this() - Describe something for use by an LLM
 
- 
          
btw_client()btw_app() - Create a btw-enhanced ellmer chat client
 
- 
          
btw_tools() - Tools: Register tools from btw
 
- 
          
btw_mcp_server()btw_mcp_session() - Start a Model Context Protocol server with btw tools
 
- 
          
use_btw_md()edit_btw_md() - Create or edit a btw.md context file
 
- 
          
btw_task_create_btw_md() - Task: Initialize Project Context File
 
- 
          
btw_this() - Describe something for use by an LLM
 
- 
          
btw_this(<character>) - Describe objects
 
- 
          
btw_this(<environment>) - Describe the contents of an environment
 
- 
          
btw_this(<data.frame>)btw_this(<tbl>) - Describe a data frame in plain text
 
Tasks and Agents
Tasks, or agents, are higher-level functions that combine system prompts and tools to perform more complex operations.
Tasks are typically designed for interactive use (e.g. to collaboratively create a project context file), but they can also be used programmatically.
- 
          
btw_task_create_btw_md() - Task: Initialize Project Context File
 
- 
          
btw_task_create_readme() - Task: Create a Polished README
 
Tools
Register all of these tools with an ellmer chat using chat$set_tools(btw_tools()). These tools generally all have counterparts available via btw() and btw_this() for interactive use. The long and awkward function names are for LLMs and to avoid name clashes with other tools.
- 
          
btw_tool_docs_package_news() - Tool: Package Release Notes
 
- 
          
btw_tool_env_describe_data_frame() - Tool: Describe data frame
 
- 
          
btw_tool_env_describe_environment() - Tool: Describe an environment
 
- 
          
btw_tool_files_code_search() - Tool: Code Search in Project
 
- 
          
btw_tool_files_list_files() - Tool: List files
 
- 
          
btw_tool_files_read_text_file() - Tool: Read a file
 
- 
          
btw_tool_files_write_text_file() - Tool: Write a text file
 
- 
          
btw_tool_git_branch_checkout() - Tool: Git Branch Checkout
 
- 
          
btw_tool_git_branch_create() - Tool: Git Branch Create
 
- 
          
btw_tool_git_branch_list() - Tool: Git Branch List
 
- 
          
btw_tool_git_commit() - Tool: Git Commit
 
- 
          
btw_tool_git_diff() - Tool: Git Diff
 
- 
          
btw_tool_git_log() - Tool: Git Log
 
- 
          
btw_tool_git_status() - Tool: Git Status
 
- 
          
btw_tool_github() - Tool: GitHub
 
- 
          
btw_tool_ide_read_current_editor() - Tool: Read current file
 
- 
          
btw_tool_docs_package_help_topics()btw_tool_docs_help_page()btw_tool_docs_available_vignettes()btw_tool_docs_vignette() - Tool: Describe R package documentation
 
- 
          
btw_tool_search_package_info() - Tool: Describe a CRAN package
 
- 
          
btw_tool_search_packages() - Tool: Search for an R package on CRAN
 
- 
          
btw_tool_session_check_package_installed() - Tool: Check if a package is installed
 
- 
          
btw_tool_session_package_info() - Tool: Gather information about a package or currently loaded packages
 
- 
          
btw_tool_session_platform_info() - Tool: Describe user's platform
 
- 
          
btw_tool_web_read_url() - Tool: Read a Web Page as Markdown