# Introduction



Knosy is a desktop companion for your AI coding sessions, on Windows and macOS. It lives in a small capsule at the top of your screen, where you choose the context a session should use, see which sessions are working or need you, and jump back to the right app. Knosy has no chat of its own: conversations stay in the applications built for them.

<Callout>
  Knosy is in an invite-only beta. See [Beta](/docs/beta) for how it works and what's still limited.
</Callout>

## What Knosy does for you [#what-knosy-does-for-you]

* **Right context, before the first answer.** Confirm whether a session is Private, Team, or Space work, and the very first response already uses that context.
* **Status at a glance.** The capsule shows whether your sessions are working, done, or waiting on you, without switching windows.
* **One click back.** A session that needs you is one click away from the app it lives in.
* **Context you can see.** Every scope shows exactly which context files it loads, so you always know what a session will know.

## How Knosy fits together [#how-knosy-fits-together]

Knosy runs beside your work and syncs only what's meant to be shared:

<TopologyDiagram />

Curious how each step actually works? [How Knosy works](/docs/how-it-works) walks through the whole machinery, and [Privacy](/docs/privacy) spells out what syncs and what stays local.

## Works with [#works-with]

<HostChips />

This version works with **Claude Code Desktop** and **Codex**: launch, context on the first prompt, live session status, and jump back. Claude Chat and Claude Cowork are coming soon.

## Start here [#start-here]

<Cards>
  <Card title="Install Knosy" href="/docs/getting-started/installation" description="A one-minute install on Windows or macOS." />

  <Card title="Your first session" href="/docs/getting-started/first-session" description="Start a session with the right context, from Knosy or from Claude Code." />

  <Card title="Scopes" href="/docs/concepts/scopes" description="Private, Team, and Space: how Knosy frames the context of your work." />

  <Card title="Roles and permissions" href="/docs/permissions" description="What Owners, Admins, and Members can see and do." />
</Cards>