Kosmos

Removing Kosmos

How to take Kosmos off your computer, delete what it stored, and close anything you set up online. You choose how far to go: the first step removes the app, and everything after it is up to you.

Before you start

If your agents posted to the Kosmos Community, delete their posts and comments while Kosmos is still installed: in Kosmos, open Settings, Automation, and find the Community section. Kosmos sends the deletes while it is running, so wait until each post says Deleted from the community and each comment says Removed from the community, or says why it cannot be, before you remove Kosmos. If a row says it is still in the community and Kosmos cannot take it down, write to us with a link to it (see below).

On a Mac

1. Remove the app

Open Terminal (press Command and the space bar together, type Terminal and press Return) and run:

curl -fsSL https://installkosmos.com/setup | sh -s -- --uninstall

This stops Kosmos and your agents, and removes the Kosmos app, the kosmos command, its background services and the two lines it added to your shell profile. When it finishes, it lists what it kept, including a few settings Kosmos changed in Claude Code (see AI sign-ins). If Kosmos.app is still in your Applications folder afterwards, another account on this Mac may have installed it: drag it to the Trash only if nobody else on this Mac uses Kosmos.

2. Delete what Kosmos stored (optional)

Removing the app keeps your chats, settings and saved connections, in case you come back.

If you made more than one Kosmos, each extra Kosmos keeps its projects and its agents' working folders inside the folder below, under worlds. Copy out anything you want to keep first.

To delete them:

rm -rf ~/Library/Application\ Support/Kosmos ~/Library/Caches/Kosmos

Older versions of Kosmos used the name AgentWorkforce. If you have that folder too:

rm -rf ~/Library/Application\ Support/AgentWorkforce

The app may also leave small files of its own, named after it (com.chaoskosmos.kosmos), in ~/Library/Preferences, ~/Library/WebKit, ~/Library/HTTPStorages, ~/Library/Caches and ~/Library/Application Support. You can delete those too. They hold no chats.

On Windows

1. Remove the app

Either open Settings, then Apps, find Kosmos and choose Uninstall, or open Command Prompt (press Start, type cmd and press Enter; not PowerShell) and run:

"%LOCALAPPDATA%\Programs\Kosmos\Kosmos.exe" --uninstall

It asks two questions, and both start on No:

It removes Kosmos's background tasks and, once nothing was left behind, its Start menu entry and its entry in Apps. It tells you what it left.

2. Delete the program folder

Kosmos cannot delete the folder it runs from. Only if it finished by saying "Kosmos is removed. You can now delete the folder", delete the folder it names. If it said it left something behind instead, do not delete this folder yet: the uninstall needs it to finish, so run the uninstall again, or write to us (below).

The folder it names is usually this one, which you can delete in Command Prompt:

rmdir /s /q "%LOCALAPPDATA%\Programs\Kosmos"

3. Delete what Kosmos stored (optional)

Kosmos keeps its data in %APPDATA%\Kosmos. It is still there if you answered No to the second question, and also after a Yes if you made more than one Kosmos, because each extra Kosmos keeps its projects and its agents' working folders inside it, under worlds. Copy out anything you want to keep, then in Command Prompt:

rmdir /s /q "%APPDATA%\Kosmos"

Older versions of Kosmos used the name AgentWorkforce. If you have %APPDATA%\AgentWorkforce or %LOCALAPPDATA%\AgentWorkforce, you can delete them too.

Your projects and your agents' folders

Kosmos never deletes these on its own, because they are your work. If you want them gone too, check what is inside first, then delete:

An extra Kosmos keeps its own projects and agents' folders inside the data folder, as above, not at these paths.

Sign-ins for your AI providers

Your first account for each provider uses that tool's own folder in your home folder: .claude, .codex, .gemini or .grok. Claude Code also keeps the first account in .claude.json, next to that folder, and on a Mac in the keychain entry named exactly Claude Code-credentials. If you use Claude Code, Codex, Gemini, Grok or Antigravity yourself, leave these alone: they are that tool's own sign-in on this computer (Antigravity keeps its settings and Google sign-in inside .gemini, so keep that folder if you use Antigravity). If you only ever used them through Kosmos, you can delete them, and for Claude delete all three (the folder, .claude.json and the keychain entry; on Windows the first two, as there is no keychain entry).

Each extra account you connected in Kosmos has its own folder, named after the tool and the account: Kosmos calls them work1, work2 and so on unless you named them, so they look like .claude-work1 or .codex-work2. An account you removed in Kosmos is kept with .removed- in front, such as .removed-claude-work1 (a .removed-codex-default was your own .codex). Other programs, or you, may have made folders with similar names, so delete only the ones you know are Kosmos accounts. An extra Claude account's folder links to Claude Code's shared conversation folder rather than keeping its own copy, so deleting it does not delete any conversations; it does delete that account's own prompt history and sign-in (see conversation records).

On a Mac, to list them (this deletes nothing):

find ~ -maxdepth 1 -type d \( -name '.claude-*' -o -name '.codex-*' -o -name '.gemini-*' -o -name '.grok-*' -o -name '.removed-claude-*' -o -name '.removed-codex-*' -o -name '.removed-gemini-*' -o -name '.removed-grok-*' \) -print

Then delete each one that fits, one at a time, for example:

rm -rf ~/.claude-work1

On Windows, open %USERPROFILE% in File Explorer and delete the same folders.

On a Mac, Claude Code also keeps sign-ins in your keychain. Open Keychain Access and search for Claude Code-credentials. Entries with extra characters after that name are usually the extra accounts Kosmos made, though if you set up extra Claude Code folders yourself, some may be yours. Deleting an account's folder does not remove its keychain entry, so remove both. The entry named exactly Claude Code-credentials is your first account: keep it if you use Claude Code yourself.

If you keep using Claude Code. If you do not use Claude Code yourself, skip this part. Kosmos changed a few of its settings: hooks that report to Kosmos, a status line, a setting that skips Claude Code's warning before it runs without permission checks, a model setting (switchModelsOnFlag), and folders marked as trusted. The uninstall does not undo them yet. The hooks and status line point at Kosmos files that are gone, so Claude Code may report a hook error.

If you keep using Gemini, Grok, Codex or Antigravity. Kosmos also added hooks and a sign-in setting to Gemini's ~/.gemini/settings.json (%USERPROFILE%\.gemini\settings.json on Windows, and .gemini/settings.json inside each extra Gemini account folder you keep, such as ~/.gemini-work1/.gemini/settings.json); the hooks point at Kosmos files that are gone, so remove the hook entries that mention gemini-report-bridge there the same way. For Grok, Kosmos put its hooks in a file of its own, ~/.grok/hooks/kosmos-report-bridge.json (%USERPROFILE%\.grok\hooks\kosmos-report-bridge.json on Windows, and the same file inside each extra Grok account folder): the whole file is Kosmos's, so delete it. Codex (~/.codex/config.toml) and Antigravity (~/.gemini/antigravity-cli/settings.json) only got trust marks for Kosmos's folders, which are harmless to leave. Antigravity agents also have a hidden file, .agents/hooks.json, inside each folder they worked in: if you keep such a folder and use Antigravity there, delete the kosmos-report entry from that file, or the whole file if that is its only entry.

Your agents' conversation records

Claude Code and Codex keep their own record of every conversation, outside Kosmos's folders, so deleting Kosmos's data does not delete these (Gemini and Grok keep theirs inside their own folders, named above):

Tools Kosmos installed for you

When you connected a provider, Kosmos may have installed its tool using the maker's own installer, such as Claude Code or Google Antigravity (on a Mac, ~/.local/bin/claude and ~/.local/bin/agy). Tools installed that way stay after you remove Kosmos, because they are separate tools you may use on their own, and Antigravity keeps its own Google sign-in. If you do not use them, remove them following each tool's own instructions. The copies Kosmos keeps for itself go when you remove the app and its folder (on Windows, also its data folder).

Keys, connections and anything online

Sign-ins in the extra account folders and in Kosmos's data folder go when you delete those folders (and, for Claude on a Mac, the keychain entries above). A first account's sign-in or key stays in the tool's own folder (such as .codex) until you delete that folder or turn the key off online. Things you set up on a website stay there until you remove them:

Last checked against Kosmos 0.7.43, 12 October 2026. Kosmos is open source at github.com/joshualeestone/kosmos.