CodeNomad/docs/help/ne/projects.md
Pascal André 25e75fd3f2
fix(ui): keep independent views in duplicated session tabs (#1510)
## Summary

I make duplicated project tabs on the same session keep independent
views (backlog item 19).

When the same project was open twice with the same session selected,
enabling the web preview in one tab forced it in the other, because the
preview state was keyed by folder + session. The Missions reader was
keyed by folder, and the right-panel tab and Files mode were restored
from global keys. I now attach what each tab shows to its own tab
occurrence, while messages, execution and session data stay shared.

## User-visible changes

- I keep the web preview per tab occurrence and session: mode, URL,
back/forward history, in-flight navigation and device emulation no
longer follow the other tab. Cookies and site storage stay shared
through the preview profile.
- I scope the Missions reader, selected mission/task/schedule, expanded
tree and reader disclosures to the tab occurrence. Mission data and read
acknowledgements stay shared.
- I restore the right-panel tab and Files mode
(Workspace/Changes/Commits) per tab occurrence; the global values remain
the defaults for new tabs. The browsed worktree and Files filters are
independent per tab while CodeNomad runs, without being restored after a
restart. Widths, palette, locale, rendering and panel customization stay
shared preferences.
- I keep one tab on older history while the other follows the latest
messages; both receive the same messages and execution updates.
- Closing one tab releases only its own preview resources and saved view
state; the other tab and the native session keep working.
- After a restart, each restored tab gets its own view back, but I never
load a saved page until it is explicitly reopened. A newly opened tab
starts on the conversation.

## Approach and edge cases

I centralize what a tab shows over its session in
`stores/session-surface.ts`: one typed foreground choice per tab
occurrence (conversation, web preview, file reader or Missions reader),
with activation intents so a newer gesture always wins over a delayed
one. Session binding is explicit per surface, so schedule and playbook
readers work without a conversation. The web preview, file and Missions
features keep their own resources (preview tokens, guests and history;
file drafts; Mission data and selection) and plug into this single
arbitration instead of closing each other.

I reuse the existing `instance:<instanceId>` tab identity and add a
per-tab restorable view-state envelope (`stores/tab-view-state*.ts`)
carried by each restorable tab descriptor, wired through capture, the
partitioned client-state codecs, partial-restore preservation and
hydration, so state re-attaches to the re-created instance id. Field
updates preserve untouched live branches, so an unrelated update never
cancels an in-flight Missions read, and asynchronous Missions navigation
yields to any newer surface gesture, including browser navigation.
Plain-browser and Remote Control clients persist the same envelope
through bounded local storage. I migrate legacy folder + session preview
entries to the matching restored descriptors deterministically, per
session, preferring an exact session entry over the project-wide
fallback, and remove them only after the new snapshot is published.

The real `sessionId` remains the only native authority; the occurrence
key is presentation-only. URL rules, sandboxing, guest ownership and
lease/generation fences are unchanged.

Automation targeting is explicit: `open` targets the active open tab
that owns the session, else the unique owner, else it refuses; the
chosen occurrence is kept for the whole asynchronous open and closing it
never reroutes. Page actions keep the existing native rule of exactly
one visible eligible preview, refusing ambiguity without fallback.

Each tab occurrence has a gesture generation. User gestures (clicks,
shortcuts, commands, links, new session, delete, fork, automation opens
routed to the tab) advance it: `beginGesture(ctx)` captures the
generation before any await and exposes `current()`, and
`applySurface(ctx, surface, gesture?)` applies a synchronous gesture or
adopts a captured one only while it is still current; selection actions
accept the same gesture. An older asynchronous gesture (Mission actor or
schedule navigation, task links, new session creation, history-search
navigation, explicit Git actions, browser opens) therefore never
overrides a newer one, while keeping its durable effects (a created
session stays created; a rejected preview releases its own token).
Passive updates (Git status, Mission inventory and passage
reconciliation, restoration and hydration, session/worktree changes,
preview location/history notifications) apply immediately against
current state, never advance the generation and never cancel a pending
gesture. They keep their own guards at the moment they run: a file
reader closes only when a loaded status inventory shows the file is
gone, a Mission reader is cleared only when its Mission is actually
missing, and session deletion reconciles the selected parent and child
at once.

I extract the shared active-session signal into
`stores/session-selection-state.ts`, keeping session actions, catalog
refresh and restoration authority in `stores/session-state.ts` and their
UI-effect dependencies outside the view-state import graph. I add
`tab-view-state.test.ts`, `session-surface.test.ts` and
`app-session-workspace-hydration.test.ts` to the explicit CI unit-test
lists.

I bound late-response fences to in-flight operations and open
occurrences, so repeated open/close cycles retain nothing (1,000-cycle
regression test), while a late success or error for a closed tab still
publishes nothing.

## Validation

I rebased the seven commits onto `dev` at `2541a9195`; `git range-diff`
shows six identical patches and one integrated with the Missions changes
from #1507 (shared passage acknowledgements kept, presentation scoped
per tab).

- At `a4575ac26` I replaced the deferred reconciliation queue from
earlier review rounds with the gesture generation above, reducing the
production diff from +1,446/-703 to +1,227/-690 lines under
`packages/ui/src`. `npm run typecheck` passes; the exact CI step passes
**742/742**; UI source units **2,221** passed (known
`help-url.test.ts:63`) and contract units **190/190**.
- At `22efe6da4` I migrate Mission views saved by earlier builds
(`mission-project-*` selection, reader and expanded rows;
`mission-disclosures-*` choices) into the first tab occurrence without
overriding an existing envelope; the exact CI step passes **745/745**,
and I updated three Mission browser checks to expect immediate passive
reconciliation followed by the pending browser opening.
- At `4c62b5eb1`: `npm run typecheck` passes; the exact CI step passes
**728/728**; UI source units **2,222/2,223** (known
`help-url.test.ts:63`) and contract units **190/190**; the affected
browser files pass **175/175** on Windows and on Linux; the full
Linux/Xvfb browser suite runs **2,133 passed, 2 skipped, 2 failed** (the
two known prompt-menu checks). The Mission recovery and parent/child
deletion regressions fail on `97b23df23` and pass now; a reverse-order
file lifetime/status regression covers stable reader lifetime identity
across passive retargets.
- At `97b23df23`: `npm run typecheck` passes; the exact CI step "Test
changed runnable UI behavior" passes **724/724** on Windows and Linux;
full UI source and contract units pass **2,402/2,403** on both, the
remaining one being the known `help-url.test.ts:63`; the affected
browser files pass **249/249** on Windows; the full Linux/Xvfb browser
suite runs **2,132 passed, 2 skipped, 2 failed** (the two known
prompt-menu checks). The new gesture/passive regressions (12 unit, 3
real-shell) fail on `b099e5a6f` and pass now.
- At `b099e5a6f`: the exact CI step passed **719/719**; full UI units
**2,389 passed** with the known `help-url.test.ts:63` failure; the
affected browser files (current-passage, Mission control,
cross-navigation, task reader, browser history, header windows, current
pages) pass **167/167** on Windows and on Linux; the agent-selector
shortcut check, which I changed to await the visible search popup with
focus and Escape dismissal instead of a transient focus precursor,
passes **10/10** on each platform; the full Linux/Xvfb browser suite
runs **2,129 passed, 2 skipped, 2 failed** (the two known prompt-menu
checks). Each Missions race regression fails on the commit before its
fix and passes now.
- The earlier results below are from previous review rounds, kept as
historical evidence.
- After the second review round, the full Linux/Xvfb browser suite ran
**2,118 passed, 2 skipped, 2 failed** (the two known prompt-menu
checks); the affected browser files ran **116/116** on Windows and on
Linux; full UI unit tests pass on both except the known
`help-url.test.ts:63`.
- After the first review round, the full Linux/Xvfb browser suite ran
**2,106 passed, 2 skipped, 3 failed**: the two known prompt-menu checks,
and a standalone Missions fixture missing tab ownership registration,
which I corrected without changing its assertions (**33/33** on Windows
and Linux afterwards). Electron controller/lifetime/security **29/29**;
help **31/31**.
- New duplicate-tab coverage: a surface transition matrix with
delayed-open races (`session-surface.test.ts`), real localhost clicks,
diff readers and session/Info/history isolation in two tabs, and a
production capture/restore scenario with reorder, duplicate close,
recreated instance ids and no automatic page load
(`tab-view-persistence.test.ts`).
- After the rebase: Missions UI units **347 passed**, tab-state/preview
units **17 passed**, server recurrence **115 passed**, and **373 browser
tests across 20 files** passed, including the duplicate-tab suites
`session-browser-history.test.ts` and `history-navigation.test.ts`.
- Before the rebase, independent QA ran the full UI browser suite on
Windows and on Linux/Xvfb, the full UI unit tests on both, Electron
controller tests and Tauri Rust controller regressions. Duplicate-tab
scenarios run on real Solid components, real Electron guests, the Tauri
IPC boundary and the iframe fallback.
- I tested Tauri at its IPC boundary and through its Rust controller
tests only; I did not run a native WebKit/WebView2 Tauri app.
- Failures I reproduced identically on the previous `dev` base and left
unchanged: `help-url.test.ts:63`, Windows
`workspace-file-refresh.test.ts:67`, and the two Linux `the prompt menu
jumps` variants. Two intermittent Missions browser cases (Linux source
ABA read count, Windows source-picker keyboard scroll) did not reproduce
in 160 comparative runs on either side.

## Documentation

I update `docs/help/<locale>/` `browser-sidecars.md`, `projects.md`,
`files.md`, `missions.md`, `desktop.md` and `settings.md` in all ten
languages, along with `BROWSER_AUTOMATION.md`,
`BROWSER_DEVICE_EMULATION.md`, `UI_SHELL.md`, `PROJECTS.md`,
`FILES_PANEL.md`, `MISSIONS.md` and `architecture.md` under `dev-docs/`.
No new UI strings.

## Long files touched

Under `packages/ui/src/`: `App.tsx` (~910 lines),
`components/browser-frame.tsx` (~1,052),
`components/instance/instance-shell2.tsx` (~1,344),
`components/instance/shell/right-panel/tabs/MissionControl.tsx` (~891),
`components/instance/shell/right-panel/useGitChanges.ts` (~586),
`components/message-block.tsx` (~1,775), `components/mission-reader.tsx`
(~556), `components/session-list.tsx` (~1,165),
`components/session/session-view.tsx` (~731),
`lib/hooks/use-commands.ts` (~683), `stores/session-actions.ts` (~744),
`stores/session-state.ts` (~1,375), `stores/session-api.ts` (~2,074),
`stores/client-state-partitions.ts` (~557). Tests:
`history-navigation.test.ts` (~1,812), `session-browser-history.test.ts`
(~1,029), `header-windows.test.ts` (~1,090),
`mission-current-passage.test.ts` (~807),
`browser_controller_regressions.rs` (~962). Workflow:
`.github/workflows/pr-build.yml` (~1,074).
2026-11-16 02:38:07 +01:00

89 lines
19 KiB
Markdown

# परियोजना र worktree
परियोजना ट्याबले CodeNomad लाई ब्याकएन्ड कम्प्युटरको फोल्डरसँग जोड्छ। ट्याब खोल्नु, checkout ब्राउज गर्नु र कुराकानी परिवार सार्नु फरक कार्य हुन्।
## परियोजना खोल्नुहोस् {#open-project}
1. गृह पृष्ठ खोल्न **नयाँ उदाहरण** (`+`) क्लिक गर्नुहोस्।
2. **फोल्डरहरू ब्राउज गर्नुहोस्** रोजी ब्याकएन्ड फोल्डर चयन गरेर खोल्नुहोस्; वा **भर्खरका फोल्डरहरू** अन्तर्गतको प्रविष्टि रोज्नुहोस्।
3. रिपोजिटरी प्रतिलिपिका लागि **Git Repo क्लोन गर्नुहोस्** रोजी **रिपोजिटरी URL** र **गन्तव्य फोल्डर** भर्नुहोस्, अनि **क्लोन गर्नुहोस्**। **गन्तव्य फोल्डर** मा तपाईंको पछिल्लो क्लोन भएको फोल्डरभित्र (नभए सबैभन्दा हालको प्रोजेक्टको छेउमा) रिपोजिटरीको नाम पहिल्यै भरिन्छ। **ब्राउज गर्नुहोस्** ले क्लोन राख्ने फोल्डर छान्छ; क्लोनको फोल्डर नामसहित path आफैँ पनि बदल्न सकिन्छ।
रिमोट सर्भर ब्राउज गर्नु त्यस सर्भरको फाइल प्रणाली ब्राउज गर्नु हो, आफ्नो फोन वा ल्यापटपको होइन। परियोजना खोल्दा प्रत्येक ट्याबको छुट्टै OpenCode daemon बन्दैन। कुराकानी नेटिभ OpenCode सत्र हुन्; तिनको आयु ट्याबको आयु होइन।
क्लोनले गन्तव्यमा रिपोजिटरी लेख्छ। **यदि पहिले नै अवस्थित छ भने पहिले गन्तव्य फोल्डर हटाउनुहोस्।** विनाशकारी छ: त्यहाँका सबै सामग्री मेट्न मिल्दा मात्र सक्षम गर्नुहोस्। अनिश्चित भए नयाँ गन्तव्य प्रयोग गर्नुहोस्।
भर्खरका प्रविष्टि shortcut हुन्। **कार्यस्थान पुन: नामकरण गर्नुहोस्** ले देखिने नाम बदल्छ; **भर्खरको सूचीबाट हटाउनुहोस्** ले shortcut हटाउँछ, फाइल वा कुराकानी होइन। पहिले नै खुला recent परियोजना क्लिक गर्दा नयाँ ट्याब खुल्छ; त्यसको सट्टा विद्यमान ट्याब चयन गर्न त्यसको **खोल्नुहोस्** बटन (**खुला परियोजनामा जानुहोस्**) प्रयोग गर्नुहोस्।
उही फोल्डर दुई पटक खोल्नुहोस् र दुवै ट्याबमा उही कुराकानी छान्नुहोस्, ताकि एउटामा chat र अर्कोमा वेब पूर्वावलोकन, फाइल वा मिसन प्रतिवेदन राख्न सकियोस्। प्रत्येक ट्याबले आफ्नै दृश्य, कुराकानीको scroll स्थान, दायाँ प्यानलको चयन र फाइलहरू मोड राख्छ; सन्देश, कार्यान्वयन र परियोजना डेटा साझा रहन्छन्।
## नयाँ-इन्स्ट्यान्स launcher प्रयोग गर्नुहोस् {#new-instance-launcher}
1. `+` लामो थिच्नुहोस् वा right-click गर्नुहोस्; त्यहाँ keyboard focus हुँदा **Alt+Down**, **Shift+F10** वा Menu key प्रयोग गर्नुहोस्।
2. भर्खरका परियोजना खोज्नुहोस्, वा **ब्राउज…**, **अस्थायी** वा **क्लोन…** चयन गर्नुहोस्।
सामान्य क्लिकले अझै पूर्ण गृह पृष्ठ खोल्छ। launcher shortcut हो, व्यवस्थापन सतह होइन: recent परियोजनाको नाम बदल्न/हटाउन र सर्भर bookmark व्यवस्थापन गर्न गृह पृष्ठ प्रयोग गर्नुहोस्। Escape ले launcher बन्द गरी `+` मा focus फर्काउँछ।
## ट्याब बन्द गरेर परियोजना बन्द गर्नुहोस् {#close-stop}
1. ट्याबको close बटन वा कमाण्ड प्यालेटको **ट्याब बन्द गर्नुहोस्** (renderer मा `Ctrl/Cmd+W`) प्रयोग गर्नुहोस्।
2. ट्याब बन्द गर्दा त्यो परियोजना CodeNomad मा बन्द हुन्छ: CodeNomad ले त्यसका event र अनुरोध पछ्याउन छोड्छ। सत्र OpenCode मा चलिरहन्छन्।
3. Browse वा Recents बाट फोल्डर फेरि खोल्दा ती कुराकानी फेरि भेटिन्छन्।
| कार्य | दायरा र असर | यसले नगर्ने काम |
| --- | --- | --- |
| ट्याब बन्द | त्यो ट्याबको CodeNomad परियोजना जडान हटाउँछ; उही फोल्डरमा छुट्टै खोलिएको अर्को ट्याब प्रभावित हुँदैन | परियोजना फाइल वा नेटिभ इतिहास मेट्दैन, सत्र रोक्दैन वा OpenCode को Location unload गर्दैन |
| सत्र रोक्ने | चयन गरिएको कुराकानीको कार्यान्वयन | परियोजना बन्द वा इतिहास मेट्दैन |
उही परियोजना जडान अर्को विन्डोमा पनि देखाइएको छ भने त्यहाँको ट्याब पनि बन्द हुन्छ र त्यो विन्डोले सूचना देखाउँछ। बन्द गरिएको ट्याबका नपठाइएका मस्यौदा र संलग्नक त्यही विन्डोमा उही फोल्डर फेरि खोल्दा फर्किन्छन्; विन्डोले हालै बन्द गरिएका 16 परियोजनासम्मका लागि reload वा बन्द नहुँदासम्म तिनलाई राख्छ। तिनीहरू startup restoration को भाग होइनन्।
पूरै विन्डो बन्द गर्दा, एप बन्द गर्दा वा reload गर्दा त्यसका परियोजना जडान बन्द हुँदैनन्; सामान्य startup restoration लागू रहन्छ। कार्यान्वयन सकियो भनी प्रमाणित गर्नुपरे सम्बन्धित run स्पष्ट रोक्नुहोस्। CodeNomad ले नेटिभ Location कहिल्यै unload गर्दैन; साझा-सेवा मर्मत [OpenCode सेटअप](opencode.md) मा छ।
सुरुवाती पुनर्स्थापना सक्षम हुँदा, बाँकी प्रत्येक ट्याबले आफ्नै प्यानल चयन, मिसन चयन/reader र सुरक्षित ब्राउजर URL/इतिहास पुनर्स्थापित गर्छ। सुरक्षित ब्राउजर पृष्ठ स्पष्ट रूपमा फेरि खोल्दा लोड हुन्छन्। एउटै फोल्डरका ट्याबमध्ये एउटा बन्द गर्दा त्यसको सुरक्षित दृश्य मात्र हट्छ; फोल्डर फेरि खोल्दा नयाँ ट्याब बन्छ।
## अस्थायी कार्यस्थान {#temporary-workspaces}
1. launcher मा **अस्थायी** वा गृह पृष्ठमा **नयाँ अस्थायी उदाहरण** रोज्नुहोस्।
2. खाली CodeNomad-व्यवस्थित फोल्डरमा काम गर्नुहोस्; Git स्वतः सुरु हुँदैन।
3. ट्याब बन्द गर्दा **राख्नुहोस्**, **हटाउनुहोस्** वा **रद्द गर्नुहोस्** रोज्नुहोस्। ट्याब menu मा **परियोजनाको रूपमा राख्नुहोस्** पनि छ।
| चयन | असर | पुनःप्राप्ति |
| --- | --- | --- |
| राख्ने | परियोजना CodeNomad मा बन्द गर्छ, फोल्डर र कुराकानी राख्छ, अस्थायी स्थिति हटाएर recent परियोजना थप्छ | Recents बाट फेरि खोल्नुहोस्; फोल्डर सर्दैन |
| हटाउने | अस्थायी कार्यस्थानका कुराकानी, फाइल र नपठाइएका मस्यौदा मेट्छ | Undo छैन; चाहिने कुरा पहिले अन्तै बचत गर्नुहोस् |
| रद्द | अस्थायी कार्यस्थान खुलै राख्छ | काम जारी राख्नुहोस् वा पछि निर्णय गर्नुहोस् |
कुराकानी, फाइल वा नपठाइएको मस्यौदा नभएको अछुतो अस्थायी ट्याब बन्द गर्दा चुपचाप हटाइन्छ। खुला अस्थायी ट्याब सामान्य startup restoration मा समावेश हुन्छन्, तर बन्द अस्थायी फोल्डर फेरि सुरु गर्न गृह पृष्ठमा छुट्टै सूची छैन।
कुराकानी चलिरहेको वा फोल्डर अर्को ट्याब/विन्डोमा खुला हुँदा Discard अस्वीकार हुन्छ। पहिले run रोक्नुहोस् र अरू दृश्य बन्द गर्नुहोस्। हटाइ असफल भए अस्थायी नै रहन्छ: parent डाइरेक्टरी हातैले मेट्नुको सट्टा बताइएको समस्या समाधान गरी फेरि प्रयास गर्नुहोस्।
## worktree चयन वा सिर्जना {#select-create-worktree}
1. parent कुराकानी खोलेर कम्पोजर worktree selector प्रयोग गर्नुहोस्। साँघुरो लेआउटमा यो तीर-मात्र नियन्त्रण हुन्छ।
2. पत्ता लागेको विद्यमान worktree चयन गर्नुहोस्, वा **+ Worktree सिर्जना गर्नुहोस्** रोज्नुहोस्।
3. सिर्जनाका लागि **नाम** भरेर **Worktree सिर्जना गरी प्रयोग गर्नुहोस्** रोज्नुहोस्।
प्रोजेक्ट रिपोजिटरीभित्रको फोल्डर हो भने त्यो फोल्डर भएका worktree मात्र देखाइन्छन्। यस्तो फोल्डरबाट worktree बनाउन Git ले त्यसलाई ट्र्याक गरेको हुनुपर्छ। नयाँ branch नाम चयन गरिएको checkout को HEAD बाट सुरु हुन्छ। विद्यमान branch नामले त्यस branch को हालको revision प्रयोग गर्छ; अर्को ठाउँमा checkout भएको branch लाई Git ले अस्वीकार गर्न सक्छ। worktree ले default `.codenomad/worktrees` स्थान प्रयोग गर्छन्। commit नभएका परिवर्तन मूल checkout मै रहन्छन्; सिर्जनाले नयाँ worktree मा तिनको प्रतिलिपि गर्दैन।
कम्पोजर selector ले parent कुराकानी र सबै तहका descendants लाई प्रमाणित परिवारका रूपमा सार्छ। उप-सत्रले यो selector स्वतन्त्र बदल्न सक्दैन। सक्रिय सत्रले कार्य रोक्छन्: परिवारलाई सकिन दिनुहोस् वा पहिले कार्यान्वयन रोक्नुहोस्। अर्को move माग्नुअघि अघिल्लो टुङ्गिन पर्खनुहोस्; त्रुटि भए फेरि प्रयासअघि ताजा कुराकानी/worktree अवस्था जाँच्नुहोस्।
यसको विपरीत [फाइल](files.md) को **हेर्ने कार्यवृक्ष** ले प्यानलले पढ्ने checkout मात्र बदल्छ। कुराकानी सार्दैन, branch switch गर्दैन वा अर्को shell आदेश चल्ने ठाउँ बदल्दैन।
## worktree हटाउनुहोस् {#remove-worktree}
1. कम्पोजर worktree सूचीमा हटाउन मिल्ने branch worktree का लागि **Worktree मेटाउनुहोस्** प्रयोग गर्नुहोस्।
2. लक्ष्य फोल्डर समीक्षा गर्नुहोस्। स्थानीय परिवर्तन गुमाउन नमिलेसम्म **बलपूर्वक मेटाउनुहोस् (स्थानीय परिवर्तनहरू खारेज गर्नुहोस्)** बन्द राख्नुहोस्।
3. मेटाइ पुष्टि गरी परिणामी inventory जाँच्नुहोस्।
मेटाइले worktree को स्थानीय फोल्डर हटाउँछ। Git को मुख्य checkout हटाउन मिल्ने लक्ष्य होइन। CodeNomad ले प्रभावित कुराकानी परिवार मूल checkout मा फर्काएर तिनको स्थान प्रमाणित गरेपछि worktree हटाउँछ; सक्रिय सत्रले हटाइ रोक्न सक्छन्। मेटाइ commit नभएका फाइलको archive वा backup होइन।
Git ले modified/untracked फाइलका कारण अस्वीकार गरे ती जोगाउनुहोस् वा सफा गरेर पुनःप्रयास गर्नुहोस्। बलपूर्वक मेटाइले ती स्पष्ट रूपमा नष्ट गर्छ। डाइरेक्टरी lock भए त्यसलाई प्रयोग गर्ने टर्मिनल, editor, watcher र background प्रक्रिया बन्द गर्नुहोस्। निदान साझा गर्न त्रुटि संवादले **Sanitized प्रतिलिपि गर्नुहोस्** दिन्छ; sanitized पाठ पनि पहिले समीक्षा गर्नुहोस्।
## Git सुरु वा त्यसबिना काम गर्नुहोस् {#initialize-git}
1. Git उपलब्ध सामान्य फोल्डरका लागि **फाइलहरू → परिवर्तनहरू** वा **कमिटहरू** खोल्नुहोस्।
2. **Git सुरु गर्नुहोस्** रोज्नुहोस्। यसले थप पुष्टिबिना तुरुन्त काम गर्छ।
3. परियोजना metadata र कुराकानी ताजा हुन पर्खनुहोस्; CodeNomad बाहिर Git सुरु गरिएको भए **रिफ्रेस** प्रयोग गर्नुहोस्।
सुरुवातले स्पष्ट खोलिएको फोल्डरमा रिपोजिटरी बनाउँछ, त्यसको parent मा होइन। यसले commit गर्दैन।
ब्याकएन्डले Git चलाउन नसके स्पष्ट खोलिएको फोल्डरका लागि directory-only मोडमा कुराकानी र सीमित फाइल ब्राउज उपलब्ध रहन्छन्। worktree कार्य र Git सुरुवातका लागि त्यही ब्याकएन्डमा Git चाहिन्छ। [स्थापना](install.md) र [फाइल](files.md) हेर्नुहोस्।