PandaOSPandaOS
Projects and workspace

Projects

Turn a folder into a project, so every chat in it knows your rules, your files and how to run your work.

Feature Updated 20 Nov 2026

What a project is

A project is a folder on your computer that PandaOS knows about. A chat outside a project knows nothing about your work. A chat inside one starts with everything the project carries:

  • Rules it follows without being reminded.
  • Knowledge files for what the code does not say.
  • With coding tools on, a dev server with a live preview beside the chat, a terminal and credentials.
  • Git, with written commit messages.
  • Connected apps scoped to this work.
The overview with a project and without one: rules, knowledge, connectors and the dev server belong to the project, while agents, skills and apps come along everywhere.

Where to find your projects

Every project has a tile on the dashboard and a place in the sidebar, with its chats inside it. Open a project and its overview shows its rules, knowledge, apps and dev server.

Make one

Press New Project in the sidebar, or the New tile on the dashboard. Choose New project, Open existing folder or Clone a repository. For code, PandaOS works out how the project is built and suggests how to start it. For writing, research or design it indexes what is there so Panda can refer to it. Or start from a project starter.

The dashboard: recent sessions across every project, and the project row beneath them.
The dashboard: recent sessions across every project, and the project row beneath them.

A project inside a larger repository

If the part that runs lives in a subfolder, such as apps/frontend/, tell Panda which subfolder holds the app. On the Dev servers tab of the project settings, set that subfolder as the server's Working directory, so the dev server starts there. Git history and references across packages still see the whole repository.

Clone a project from GitHub

Press the New tile on the dashboard and choose Clone a repository, or pick Clone Repository in the command palette.

  1. Press Sign in with GitHub the first time.
    A device code such as ABCD-1234 appears and is copied for you. Press Open GitHub, paste the code and authorize PandaOS. PandaOS notices on its own when you are done, and you stay signed in. To clone a public repository without signing in, press or paste a URL manually.
  2. Pick the repository.
    Type in Repository URL and choose from your repositories, up to 20 at a time, or paste a full URL.
  3. Check where it goes.
    Clone to fills in a folder named after the repository. The folder button beside it picks another.
  4. Press Clone.
    The setup dialog asks how to run it, then the project is added.

Sign GitHub out again

Press Disconnect next to your GitHub name in the clone dialog. PandaOS removes the stored sign-in.