Quick start

Install Kosmico, turn a folder you already have into a project, and get a first answer out of Kosmo.

By the end of this page you will have a project open and Kosmo working inside it.

Step 1: Get the app

Download the desktop app for macOS or Windows from the downloads page, or open the web app and sign in. The desktop app is the one to pick if you want a terminal, Jupyter kernels, or local models.

Step 2: Create a project

The launcher lists your projects and is where new ones start.

  1. Click New Project.
  2. Choose the folder you want to work in. Kosmico opens the files already in it.
  3. Name the project and create it.

Two shortcuts sit alongside that. Templates create a new folder from a starting structure instead of adopting an existing one. And if you allow it, Kosmico reads the session history of local AI coding tools, Claude Code, Codex, Cursor, and opencode, to suggest folders you worked in recently. That check happens on your machine and nothing about it is sent anywhere.

Step 3: Look around

The project opens on the dashboard. The sidebar organizes files, Research Map, Kosmo Agents, Deep Research, Knowledge Graph, Bibliography, Presentations, and the available desktop tools. Panels hold tabs, and you can keep several open at once.

The first-run orientation points to these surfaces inside your own project. Choose Settings → Tours to restart the introduction, resume a tour, or open one specific step later.

Press Cmd+K (Windows: Ctrl+K) to search the project by filename or by content.

Step 4: Ask Kosmo something

Press Cmd+Shift+A (Windows: Ctrl+Shift+A) to open Kosmo.

Start with something that needs the project rather than general knowledge, because that is what it is for:

Read @paper.tex and tell me which claims in the results section have no citation.

Typing @ brings up a file and folder picker. Kosmo reads what you reference before it answers.

Out of the box Kosmo is in Agent mode, which means it makes changes as it works rather than describing them. If you would rather see the plan first, switch to Plan in the composer.

Tip: Kosmo asks permission before running anything on your machine. You can allow a command once, or always.

Step 5: Turn on cloud sync if you need it

A local project is enough for solo work. Enable cloud sync when you want the project on another machine, in the web app, or shared with a co-author.

Next steps