> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newly.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects, chats, Remote and Local

> How Newly v2 organizes your work into projects and chats, and where each chat runs.

In Newly v2, at app.newly.app and in Newly for Mac, your work is organized into projects and chats. Each chat runs either in the cloud (Remote) or on your Mac (Local).

## Projects

A project is one app. It holds your app's code, its chats, and its backend if it has one.

You create a project by sending your first prompt from Home. Newly names the project from the first line of your prompt, then starts a chat in it. See [Build your first app](/get-started/quickstart).

### Finding your projects

The Home sidebar has a **Projects** group with three views:

* **All Projects**: every project you can open.
* **Created by me**: projects you created.
* **Shared with me**: projects other people shared with you. See [Share a project](/code/sharing-projects).

Until you pick a view, the list under the group is **Recents**: your 5 newest projects.

When you have projects, the banner on Home shows your last project with "Pick up where you left off." Press **Open Project** to go straight back to it.

A project's address in the web app is `app.newly.app/projects/<id>`. The id at the end is your project id, which you also use with the newly CLI. See [Get your code](/code/get-your-code).

## Chats

A project can have many chats. Start another one with the **+** (New chat) button in the chat header.

* Each chat keeps its own conversation and its own memory of what you discussed.
* A chat runs one request at a time. Messages you send while the agent works wait in a queue. See [Chatting with the agent](/build/chatting-with-the-agent).
* Separate chats are useful for separate pieces of work, such as one chat for a new screen and another for a bug.

### All chats share the project's code

By default, every chat in a project works on the same code. A change made in one chat is in the code that every other chat works on next. If you use **Restore to here** or **Undo** in one chat, the code goes back for every chat in the project.

See [Where your code lives](/code/where-your-code-lives) and [Undo and Restore to here](/code/undo-and-restore).

### Running and parked chats

By default, up to 3 Remote chats can run at once. An idle Remote chat parks after about 15 minutes, and your next message resumes it. A chat doesn't park while the agent is working or a native build is running. See [Parked chats and limits](/build/sleep-and-limits).

## Remote and Local

Every chat is either Remote or Local.

* **Remote**: "Runs in the cloud, accessible on any device." Remote chats always use Newly Agent, which uses your Newly credits. Every chat in the web app is Remote.
* **Local**: "Runs on your computer, Device must stay awake." Local chats exist only in Newly for Mac. They can use Newly Agent (which uses credits) or your own Claude or Codex login. See [Local chats on your Mac](/mac/local-chats).

|                          | Web app                           | Mac app, Remote chat              | Mac app, Local chat                                                             |
| ------------------------ | --------------------------------- | --------------------------------- | ------------------------------------------------------------------------------- |
| Where it runs            | In the cloud                      | In the cloud                      | On your Mac                                                                     |
| Agent                    | Newly Agent                       | Newly Agent                       | Newly Agent, or your own Claude or Codex login                                  |
| Your Mac must stay awake | No                                | No                                | Yes                                                                             |
| Previewing               | Cloud simulators and the Web view | Cloud simulators and the Web view | Your Mac's simulator once it's set up, otherwise cloud simulators. No Web view. |

### Choosing Remote or Local on Mac

In the Mac app, pick **Remote** or **Local** from the menu in the prompt box before you send the first message of a chat.

* A new chat uses the choice you made last time. If there isn't one, it starts as Local.
* A Local chat needs a folder on your Mac for the project. On Home, use **Save project to...** to pick one, or the Mac app asks you when you send the prompt.
* A Remote chat needs nothing installed on your Mac and works the same as in the web app.

Once a chat has started, it stays Remote or Local. To move an existing chat between the cloud and your Mac, turn on Developer mode. See [Settings and Developer mode](/account/settings).

## Where your chat history shows up

| Chat                               | Web app   | Mac app          |
| ---------------------------------- | --------- | ---------------- |
| Remote chat                        | Yes       | Yes              |
| Local chat in a Newly project      | Read-only | Yes              |
| Local chat in a folder on your Mac | No        | Only on that Mac |

When you open a Local chat in the web app, you can read it but not send messages. The web app shows "This chat runs in the desktop app. Open Newly on your computer to continue the conversation."

## Related

<CardGroup cols={2}>
  <Card title="Share a project" icon="user-plus" href="/code/sharing-projects">
    Invite people and choose what they can do.
  </Card>

  <Card title="Delete a chat, project or account" icon="trash" href="/account/delete">
    What you can restore, and for how long.
  </Card>

  <Card title="Parked chats and limits" icon="moon" href="/build/sleep-and-limits">
    Parking, resuming and the one-hour turn limit.
  </Card>

  <Card title="The web app and Newly for Mac" icon="laptop" href="/get-started/web-and-mac">
    What each one can do.
  </Card>
</CardGroup>
