The docs
Everything you need to install Kosmos and put your first agent to work, in plain words.
- What Kosmos is
- Installing
- Your first agent
- Where things live
- On a second computer
- Updates
- Removing it
- Open source
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.
On a second computer
With Kosmos Plus, a second computer, such as a laptop, can open the agents that run on your main one. Using Kosmos on a second computer covers setting it up and what works there.
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
On a Mac, the same line that installs Kosmos removes it: the installer
with --uninstall removes the app and its services. On
Windows, remove it in Settings, Apps. Your projects and your
agents' work folders stay unless you delete them, because they are yours;
your chats and settings stay too unless you choose to delete them (Windows
asks). Removing Kosmos has the exact
steps, including how to delete what Kosmos stored and turn off access you
gave it.
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.