TerragonTerragon Docs
Resources

Release Notes

Stay up to date with the latest changes and improvements to Terragon.

August 28, 2025

Features

  • GPT-5 reasoning variants: Added support for Low, Medium, and High reasoning variants when using the GPT-5 model
  • Context usage display: Context usage is now displayed within tasks above the prompt box
  • Improved task list UI (out of early access): Your task list is now always accessible from the sidebar when you're on the Home page or when viewing tasks.
  • Plan Mode for Claude Code (out of early access): You can now use Claude Code's plan mode when creating new tasks. When a task is created in plan mode, Claude will provide a detailed implementation plan for you to approve or edit before any changes are made. To enable plan mode, in the prompt box change the mode selector in the bottom left to "Plan".
  • Edit GitHub action workflows: Terragon can now create and edit GitHub Action workflows in your repository
  • CLI Enhancements:
    • Added new --model flag for the CLI create command so you can specify which AI model to use when creating tasks
    • Added new --mode flag for the CLI create command so you can specify whether to create tasks in plan or execution mode (Claude Code only)

UX Improvements & Bug Fixes

  • Improved shell environment: The agent now runs inside a Bash shell environment where the ~/.bashrc file is automatically sourced. If you install tools, SDKs, or other dependencies that rely on ~/.bashrc (for example, updating your PATH to include a new binary), the agent will pick them up automatically. This should make it easier to use tooling like nvm and pyenv.
  • Increased sandbox and setup script timeouts to 15 minutes (previously 5 minutes)
  • Added WebSearch and WebFetch as allowed tools in plan mode (Claude Code only)
  • Fixed redirect after retrying tasks
  • Fixed overflow UI issues in agent settings
  • Fixed page flickering issue on Home page
  • Improved landing page layout and visual hierarchy
  • In early access:
    • Git checkpointing can now be controlled when creating new tasks instead of being an environment setting. Click the cloud icon under the prompt box on the Home page to toggle this setting.

August 15, 2025

Features

  • Increased Automation Limits: You can now create up to 20 automations (previously 5) to support more complex workflows
  • MCP Support in Codex: You can now use MCP servers with the Codex agent
  • New features in early access:
    • Plan Mode for Claude Code: You can now use Claude Code's plan mode when creating new tasks. When a task is created in plan mode, Claude will provide a detailed implementation plan for you to approve or edit before any changes are made. To enable plan mode, in the prompt box change the mode selector in the bottom left to "Plan".
    • Suggested Task Pills: Manual automations now appear as suggested tasks below the prompt box
    • Disable Automatic Git Checkpointing: New environment setting to turn off automatic git checkpointing and branch protections that prevent pushing to the default branch. This is useful when you want to set up your own custom git workflows. You can change this setting for each of your repositories on the Environments page.
    • Updated tasks creation behavior: Tasks now open automatically after creation

UX Improvements & Bug Fixes

  • Fixed text and code block overflow issues in thinking messages from the agent
  • Setup script output now displays properly when testing a script
  • Improved error handling when creating new tasks with clearer error messages
  • Codex can now use the gh command to interact with GitHub

August 12, 2025

Features

  • Connect your ChatGPT subscription to use with Codex: You can now use an existing ChatGPT subscription to power the Codex agent instead of providing an OpenAI API key. Just go to Settings and navigate to the ChatGPT Account section. If you already have an OpenAI API key connected, you'll need to disconnect that first if you want to connect your ChatGPT subscription.
  • Early access program: You can now opt into an early access program to try out new features as they're being developed and before they're released to everyone. Now in early access: an improved UI where your task list is always accessible from the sidebar when you're on the Home page or viewing tasks.

New features

UX Improvements

  • Settings are now grouped into thematic sections for easier navigation
  • Simplified the "Create pull request button" in the Code menu inside of tasks to better reflect user settings
  • New and improved landing page

Bug Fixes

  • Fixed a bug where Claude would hang if a /compact command was queued
  • Fixed a bug where Codex would hang if it ran a command that never terminated
  • Fixed a bug where Codex didn't respect custom system prompts, available in Settings
  • Resolved issue where you couldn't select Codex as an agent if you had a Claude Pro subscription
  • Git conflict resolution now works in Codex rather than prompting you to login

August 7, 2025

Features

  • GPT-5 Model Support: You can now select GPT-5 when using the Codex agent.
  • PDF Support: Upload and preview PDF files when creating tasks, either via drag and drop or by clicking the paperclip icon in the prompt box.
  • Support for SSE MCP servers: You can now use SSE-based MCP servers, in addition to the previously supported command-based and HTTP-based MCP servers. Add and update MCP configurations from Environments
  • New Tools in Sandboxes: Sandboxes now have ripgrep pre-installed.

UX Improvements

  • Model Selector Improvements: Revamped the model selector to include explicit model versions for Claude Code models, and improve visual hierarchy when choosing between multiple agents.
  • New Collapsed State for the Sidebar: The collapsed state of the sidebar now shows icons and tooltips for each page of the app, so you can quickly navigate between pages while keeping the sidebar collapsed.

Bug Fixes

  • Improved error handling when using the Codex agent
  • Fixes instances where Terragon wasn't willing to use gh commands to interact with GitHub

August 5, 2025

Features

  • OpenAI Codex Agent: Introducing support for OpenAI's Codex as an alternative agent. Configure your OpenAI API key in Settings then select from the Codex mini, o4 mini, o3, or o3 Pro models in the model selector.
  • Opus 4.1: Selecting Opus in the model selector now uses Opus 4.1
  • Environment-Specific Setup Scripts: You can now define a setup script from Environments without committing a terragon-setup.sh file to your repository. Environment scripts take precedence over those defined in terragon-setup.sh files.
  • New Github Integration Settings:
    • Control whether GitHub @mentions in PRs are added to existing threads or create new tasks
    • Control whether PRs are opened as 'Draft' or 'Ready for review'
  • New tools in Sandboxes: Sandboxes now have jq and uv pre-installed

UX Improvements

  • Improved Subagent Support: When you use Claude Code subagents, we now show the name of the subagent and the agent's color for improved confirmation the subagent is working as expected
  • Diff Context in GitHub mentions: Mentioning @terragon-labs in GitHub PR comments now includes context of the diff in the message back to Terragon
  • Clarified Task Sharing Permissions: The "Anyone with the link" permission was updated to "Logged in users with the link" to accurately reflect the actual behavior
  • Additional Context in Push Notifications: Push notifications now include the task name for improved context
  • Improved Setup Script Timeout Handling: We extended the setup script timeout to 5 minutes and now show the output of the script and which commands ran if it times out
  • Improved GitHub Code Citations: Code citations in agent messages now link to the relevant file in GitHub for improved understanding

Bug Fixes

  • Fixed UTF-8 encoding issues when pushing git commits with special characters
  • Improved handling of tool call completions in various message scenarios
  • Fixed notification display for tasks when browser tab is inactive
  • Enhanced dynamic slash command loading states in the prompt box
  • Stale tabs will now reload automatically
  • Terragon now has permission to clone multiple repositories in a single sandbox

July 25, 2025

Features

  • Automations: Create tasks that run on a schedule or via manual trigger, accessible from the new "Automations" page
  • Draft tasks: Save tasks as drafts to submit later, accessible from the segmented submit button in the prompt box
  • Retry tasks: You can now retry tasks if you want to start over with the original prompt, or edit it before trying again. Retrying a task archives the original task after you submit, and is accessible from the new "Retry" option in the submenu within a task.
  • Automatic context window management: When a task is close to the context window limit, we'll automatically compact the message history while preserving context. You'll see a warning when you're approaching the limit and indication that we'll automatically compact soon.
  • Updated Node version in the sandbox: Node.js v22 is now the default version in the sandbox due to stability issues with v24. If your project requires Node v24, you can update your terragon-setup.sh file to use it.
  • Notifications: You can now receive notifications when your tasks are complete. Enable this in settings, and make sure you have browser notifications turned on.
  • Claude Code 1.0.60: We've upgraded to the latest version of Claude Code, which includes support for custom agents.
  • MCP server: You can now use the terry cli as an MCP server. Run claude mcp add terry -- terry mcp to add it to Claude Code.
    • This allows you to manage, create, and switch tasks all from within Claude Code locally.

UX Improvements & Bug Fixes

  • Fixed a race condition that would cause the sandbox to hibernate while still running.
  • On mobile, tap the top of a task to scroll to top
  • On mobile, dismissing drawers is now more reliable
  • Fixed a bug where HTML was incorrectly stripped from prompts
  • Fixed a bug where formatting of pasted text broke if you entered new lines
  • Fixed a timezone bug on the stats page that was attributing stats to incorrect days
  • Repository selector can now be opened while still loading repositories
  • Added status monitoring for Anthropic with automatic banner display during outages
  • Archiving tasks now automatically redirects to the dashboard
  • Fixed a bug where out of memory errors in the sandbox would result in core dumps
  • Fixed a bug where queuing messages would result in errors if your Claude rate limit was hit
  • Manual API key entry with terry auth for cases where automatic authentication fails.

July 21, 2025

Features

  • Collapsible sections in task list: Sections in the task list (Today, Yesterday, This Week, Older) can now be collapsed/expanded with state persistence across page loads.
  • Task and PR Stats: You can now see your task creation and PR stats on the stats page.
  • Task renaming improvements: You can now rename tasks directly in the list view.
  • Rust & Cargo support: Rust development environment now pre-installed in all sandboxes.
  • Improved repository cloning performance: Cloning repositories is now much faster.
  • Anthropic downtime banner: In-product banner is now shown when Anthropic is having service outages
  • UI affordances for file mentions and slash commands: You can now add file references and slash commands from the new + button in the promptbox, in addition to typing @ and / directly in the promptbox.

UX Improvements & Bug Fixes

  • Fixed various horizontal overflow issues with long strings
  • Fixed task renaming on mobile devices by removing unwanted zoom on input focus
  • You can now tap outside of drawers and modals on mobile to dismiss them
  • Fixed multi-line paste behavior in the promptbox. Newlines are now handled correctly.
  • Prevent race condition when retrying a task multiple times after an error
  • Improved previews of images attached to messages. We now show the full size image where possible.
  • Fixed handling of large git changes without hanging.
  • Improve sandbox reliability for long running tasks.
  • Fix handling of timezones on the stats page.
  • Set up scripts now support default branches other than main

July 15, 2025

Features

  • Usage Statistics: Track your Claude and Sandbox usage
  • Task Sharing: Share your tasks with your collaborators:
    • Viewers see a read-only version with task owner information.
    • Tasks default to being visible to all repository members
    • You can change sharing permissions via the share modal on a task or in Settings
  • Claude rate limit handling: We now automatically queue and retry tasks if you hit your rate limit
  • New terry list CLI command: View all tasks for the current repository

UX Improvements

  • Copy anchor links to specific task messages
  • Improved message text wrapping in task view
  • Better grid layout consistency in task list view

Bug Fixes

  • Fixed git commit and push to fix race conditions where PRs failed to create
  • Fixed race condition in task queue processing
  • Fixed task status transitions for better reliability
  • Improved error handling in the agent

July 11, 2025

Features

  • Anyone can signup: Terragon is free to use while in beta.
  • Revamped docs: Much more comprehensive docs on how to use Terragon
  • Improved GitHub integration: Terragon now automatically reacts with 👀 emoji when mentioned in GitHub comments
  • Bring your own API key: For enterprise/non-claude subscribers, you can now manually enter an Anthropic API key.
  • Upload your .env files: You can now quickly setup your environments from a .env file by pasting the contents of an existing .env.

Bug Fixes

  • Fixed image removal button visibility on mobile devices
  • Git diffs now properly respect base branches
  • Consecutive user messages in the case of errors and queued follow ups are now delimited properly with newlines

July 9, 2025

Features

  • Sandbox: We've upgraded the sandbox to use Ubuntu 24.04 and now have PHP and Composer installed
  • GitHub CI status: See the CI status of your pull requests alongside your tasks
  • Progressive Web App support: You can now add Terragon to your home screen for faster access on mobile
  • Updated PR titles and descriptions: We now automatically update these when the agent makes follow up code changes
  • Task renaming: You can now manually rename your tasks
  • Slash command suggestions: Type / to see available slash commands for the agent. You can use most of the slash commands available in Claude Code today.
  • Invite your team: You can now generate access codes to invite your friends to try out Terragon

UX Improvements

  • Copy buttons for messages and code blocks
  • Floating scroll-to-bottom button for quick navigation
  • Cmd+Enter and Ctrl+Enter now submit messages (use Shift+Enter for newlines)
  • Faster @-mention suggestions
  • Improved sandbox boot times for quicker responses

Bug Fixes

  • Fixed Enter key not submitting messages properly
  • PRs now correctly use the selected base branch
  • Branches no longer push when there are no changes
  • Fixed repository selector showing empty list until page refresh

July 2, 2025

Features

  • Custom system prompts: Configure custom system prompt in Settings.
  • New task creation command in cli: Use terry create to create new tasks directly from the CLI with GitHub repository integration
  • Open in Claude: terry pull --resume now opens a conversation in Claude locally after syncing the code

Quality of Life

  • Enhanced mobile experience: Improved task header and scroll behavior on mobile devices, especially iOS Safari
  • New UI design: Refreshed interface with better visual indicators and cleaner layout
  • Improved navigation: Faster client-side navigation when accessing task pages
  • Fixed UI flickering issues when using feature flags and themes

June 30, 2025

Alpha Release

  • Run multiple coding agents simultaneously in isolated sandboxes
  • Agents open PRs for you with their work
  • Mention @terragon-labs in GitHub comments to spawn new tasks
  • Use the terry cli to continue working with the agent locally

Prompt Examples

This collection demonstrates Terragon's context capabilities through three essential examples that show how to leverage multiple context types effectively.

Early access features

Try experimental new features as they're being developed