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 2026What 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.
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.

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.
- Press Sign in with GitHub the first time.
A device code such asABCD-1234appears 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. - Pick the repository.
Type in Repository URL and choose from your repositories, up to 20 at a time, or paste a full URL. - Check where it goes.
Clone to fills in a folder named after the repository. The folder button beside it picks another. - 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.