> ## Documentation Index > Fetch the complete documentation index at: https://docs.shadowgit.com/llms.txt > Use this file to discover all available pages before exploring further. # Your first session > From adding a project to reviewing your assistant's first session, the way Get started walks you through it **Get started**, in the app, walks you through four steps, and ticks each one when it really happens. This page shows them in order. You need the ShadowGit app and an AI assistant on your computer (Claude Code, Cursor, VS Code, Codex or Claude Desktop), plus Node.js and Git, which your assistant uses to run ShadowGit's MCP server. Get started's four steps need ShadowGit 0.6.0 or later, and the MCP server's version on your assistant's row needs version 2.10.0 or later of the server. [Before you start](https://docs.shadowgit.com/installation.md#before-you-start) lists the rest. ## 1. Add a project Click **Add a project** in Get started and pick the project's folder. ShadowGit takes its first snapshot at once, and the step says so: **First snapshot saved**, with the project's name and how many files it holds. ![Get started with step 1 ticked: First snapshot saved, bookshop, 2 files, now, with an Open it button, and step 2 listing the assistants to connect](https://mintcdn.com/aflsolutions/GMEbczUQ-wV-KUa8/images/first-session/1-first-snapshot.png?fit=max\&auto=format\&n=GMEbczUQ-wV-KUa8\&q=85\&s=88b22e1a788d10b40750178cf8b36e6e) The first snapshot, saved as the project was added From then on, ShadowGit saves a snapshot as files change: right away for a large change, within a few minutes for a small one. ## 2. Connect your assistant Step 2 lists the assistants on your computer, each with **Connect**. Click it. Some assistants want a restart before they see ShadowGit, and the row says so. The other assistants are under **Other assistants**, with what to add to their config by hand. See [Installation](https://docs.shadowgit.com/installation.md) for every setup. The step ticks the first time your assistant reaches ShadowGit. Its row then reads **Connected**, with the version of ShadowGit's MCP server it runs. ![Get started's step 2 ticked, its Claude Code row reading Connected, Claude Code, MCP 2.10.0, and the other assistants' setups below](https://mintcdn.com/aflsolutions/GMEbczUQ-wV-KUa8/images/first-session/2-connected.png?fit=max\&auto=format\&n=GMEbczUQ-wV-KUa8\&q=85\&s=a9c408c044ce531dd8f61e19185c7a31) Claude Code, connected, with its MCP server's version If the step says ShadowGit's MCP server is out of date, restart your assistant: it fetches the newest server when it starts. ## 3. Start a session Step 3 gives a small first task for your project. It asks your assistant to start a ShadowGit session, read the project's map, and add a short comment at the top of the files that matter most. That's a change that is easy to review, and easy to go back on. **Copy** it and send it to your assistant. With Claude Code on your computer, **Open in Claude Code** opens it in your project with the task typed in, for you to send. Or give your assistant a real task instead: any session in the project shows up the same way. ![Get started's step 3, Start a session, with the first task for bookshop, a Copy button, Waiting for a session in bookshop, and Notify me when it finishes](https://mintcdn.com/aflsolutions/GMEbczUQ-wV-KUa8/images/first-session/2b-start-session.png?fit=max\&auto=format\&n=GMEbczUQ-wV-KUa8\&q=85\&s=6965cec09ee654c68d75fa0ab77357eb) Step 3: the first task, written for your project While your assistant works, the step says so. Turn on **Notify me when it finishes** to be told when the session ends. When it does, your assistant tells you where to review it, and the project's [Activity](https://docs.shadowgit.com/activity.md) says **Claude Code finished a session**. ![Activity for bookshop: Claude Code finished a session, Describe the two main files, 2 files, with a Review session button, and the session's row under What happened](https://mintcdn.com/aflsolutions/GMEbczUQ-wV-KUa8/images/first-session/3-finished-session.png?fit=max\&auto=format\&n=GMEbczUQ-wV-KUa8\&q=85\&s=698e754e835f6360f94bf13dbe0059bb) Activity, once the session ends ## 4. Review it Click **Review session**. The first time, a strip above the files says how to review, in three steps that tick as you do them: 1. **Read the Lens**: what your assistant changed, step by step, in its own words. **Show me** opens it. 2. **Check each file**: press `V` to mark a file read and go to the next. 3. **Send comments or mark reviewed.** **Got it** puts the strip away. **Help › How to review** brings it back. Once you've read the files, the end of the review offers what's left: **Send** your comments to your assistant if you wrote any, **Mark reviewed**, or **Go back to before this session**. Going back undoes the session's files only, and first saves a snapshot of the moment before, so you can undo it too. ![Review of Claude Code's session: the strip Your first review with Check each file ticked, and the end of the review with Mark reviewed and Go back to before this session](https://mintcdn.com/aflsolutions/GMEbczUQ-wV-KUa8/images/first-session/5-end-of-review.png?fit=max\&auto=format\&n=GMEbczUQ-wV-KUa8\&q=85\&s=69ddbea4dbc99539e76881a332f7eccf) The end of the review: mark it reviewed, or go back See [Review](https://docs.shadowgit.com/review.md) for every view and key, and [Comments](https://docs.shadowgit.com/comments.md) for what your assistant does with yours. ## Not ready yet? See an example **See an example** opens a finished example project. It's a small webshop with a day of snapshots, one Claude Code session with its Lens words, a docs page, two review comments (one answered) and a rule. You'll find it on: * the welcome's last screen; * the license page, where it needs no license; * Get started; * the empty app; * **Help**. The example is read-only: nothing in it is yours, and nothing you do changes it. **Remove example**, on its banner, takes it away. ![The example project webshop: a banner saying Example project, Nothing here is yours, with Remove example, and Claude Code finished a session, Describe the three main files](https://mintcdn.com/aflsolutions/GMEbczUQ-wV-KUa8/images/first-session/6-example.png?fit=max\&auto=format\&n=GMEbczUQ-wV-KUa8\&q=85\&s=89401fc8868a5c96a2b5f56da51793dd) The example project, labelled on every screen This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.