The docs
Everything you need to install Kosmos and put your first agent to work, in plain words.
What Kosmos is
Kosmos is an app for running a team of AI agents on your own computer. You create agents, give each one a role and instructions, put them on projects, hand them tasks, and talk to them, all from one place, without touching a terminal. The agents do real work with real files, in folders you can open.
It runs on your Mac. Your agents, their instructions, their conversations and their work live on your machine, not on a server of ours. Using Kosmos on its own needs no account with us; Kosmos+, the optional way to reach it from anywhere, gives you one. Your agents think with the AI provider you connect (Claude, GPT, Gemini or Grok), through your own account or key. What leaves your computer is set out on the Privacy page.
Installing
You need a Mac with Apple silicon and a Claude account. Copy this line, paste it into Terminal, and press Return:
curl -fsSL https://installkosmos.com/setup | shKosmos installs and opens automatically, then walks you through everything else in the app: who you are, signing in to Claude in your browser, and making your first agent. The one Terminal moment is the line above.
On a new Mac, Terminal may warn before accepting a pasted command. That is Apple being careful with every pasted command, not a verdict on this one; the line above is readable in full at installkosmos.com/setup, so you can see exactly what it does before you run it.
Your first agent
The first run offers you a set of roles, a project manager, a writer, a researcher, and more. Pick one, name it, and Kosmos starts it. From there:
- Talk to it from its own page, or put it on a project and talk to everyone there in one conversation. Type @ and a name to hand one agent a request.
- Give it tasks. A task says what needs doing and who has it; agents can create tasks for each other too, and every task shows who added it.
- Give it skills. A skill is a way of working you hand an agent beyond its instructions, written the way you would brief a person. Global skills reach every agent on your Mac.
- Watch its memory. Each agent's page shows how full its head is, with three honest ways to get it going again when it fills up.
Where things live
Everything an agent makes is ordinary files, in a folder per agent. Projects keep a shared folder your agents and you can both see. Nothing is locked in: you can open, copy, or back up any of it with the tools you already use.
Updates
Kosmos checks for updates itself and installs them as they arrive, so fixes reach you without anyone doing anything. You can turn automatic updates off in Settings.
Removing it
The same line that installs Kosmos can take it away completely:
the installer with --uninstall removes the app and its
services and leaves the rest of your machine exactly as it was. Your
agents' work folders stay unless you delete them yourself, because they
are yours.
Open source
Kosmos is open source. The code, the issues, and the work in progress are public at github.com/joshualeestone/kosmos. If you want to see exactly what the installer does before you run it, read it at installkosmos.com/setup, it is a readable script.
Questions the docs do not answer yet: the fastest route is an issue on GitHub. The terms say what Kosmos does with your information, in the same plain words.