Where Does Roo Code Store Settings and Task History?
Where the Roo Code VS Code extension keeps settings, mode configs, and task history on Windows, macOS, and Linux.
Last updated
Roo Code is a VS Code extension, so its files live where VS Code keeps extension data rather than in a Roo folder of its own. Everyday settings sit in settings.json under the roo-cline section, while keys, checkpoints, and task history sit in the globalStorage directory.
Custom modes deserve a special mention. A .roomodes file in the project root defines modes for that repo, which makes it the file to commit if the team should share them. Personal keys never belong in the repo copy. Forks like VSCodium use their own product folder names in place of Code, so swap that segment when the path looks empty.
Where Roo Code stores this, by platform
%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline
Settings in %APPDATA%\Code\User\settings.json, extension state in %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline. Paste the path into Explorer to jump there. The .roomodes file belongs in the project root, not in AppData.
~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline
Settings in ~/Library/Application Support/Code/User/settings.json, extension state in the globalStorage sibling folder. Use Go > Go to Folder in Finder since Library is hidden. Same .roomodes convention per project.
~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline
Settings in ~/.config/Code/User/settings.json with extension state under the matching globalStorage path. VSCodium and Cursor based setups use their own product folders, so swap Code for the right name if the folder looks empty.
Frequently asked questions
where are roo code settings stored
Roo Code reads the roo-cline section of VS Code settings.json plus its own .roomodes file in the workspace root. Global defaults live in your user settings.json, project overrides in .vscode/settings.json. The command Preferences: Open User Settings reaches both.
where does roo code keep api keys and task history
In the globalStorage folder of VS Code under the rooveterinaryinc.roo-cline subdirectory. It holds API keys, checkpoints, and task metadata. Deleting it logs you out and drops task history, so export anything you need first.
how do i move roo code to a new computer
Copy the globalStorage subdirectory for roo-cline plus your settings.json entries to the new machine, then reinstall the extension. Checkpoints reference workspace paths, so keep folder layouts identical or expect broken restores.
Notice an outdated path? Let us know.