Twój pierwszy projekt

W Speedwave zawsze pracujesz w obrębie projektu. Projekt to zarejestrowana przestrzeń robocza z nazwą i katalogiem na hoście. Wokół niej Speedwave porządkuje wszystko: od sieci kontenerów po dane uwierzytelniające, osobno dla każdego projektu.

Utwórz projekt

Oba interfejsy rejestrują projekt dokładnie tak samo. Skorzystaj z tego, który wolisz.

Desktop

1. Kliknij pigułkę projektu w prawym górnym rogu paska nagłówka, żeby otworzyć przełącznik projektów.
2. Kliknij + add project… i wskaż katalog, w którym chcesz pracować.

Jeśli wybrany katalog leży w folderze synchronizowanym przez OneDrive, Dropbox lub Google Drive, Speedwave ostrzeże cię przed jego dodaniem. Dopóki nie nadasz uprawnień, macOS może blokować dostęp do folderu synchronizowanego z chmurą. W takiej sytuacji kolejne okno przeprowadzi cię przez otwarcie panelu prywatności Files & Folders i ponowienie próby.

Chat my my-project

my my-project i

pa payments-api i

+ add project...

CLI

Otwórz terminal w katalogu, w którym chcesz pracować, i uruchom:

speedwave init

Polecenie to rejestruje bieżący katalog jako projekt i ustawia go jako aktywny. Jeśli pominiesz nazwę, Speedwave weźmie nazwę katalogu. Chcesz inną? Uruchom speedwave init my-project.

Nazwy projektów muszą składać się z małych liter a-z, cyfr 0-9 oraz znaków _, . i -. Nazwa zaczyna się od litery lub cyfry i liczy co najwyżej 63 znaki.

W systemie Windows Speedwave nie przyjmie katalogu głównego dystrybucji WSL jako katalogu projektu, bo to cała dystrybucja, a nie projekt. Wskaż zamiast niego podkatalog, na przykład \\wsl.localhost\<distro>\projects\<name>.

Co Speedwave tworzy wokół projektu

Rejestracja projektu dodaje wpis do tablicy projects w twojej konfiguracji użytkownika, w pliku ~/.speedwave/config.json, wraz z polami name i dir. Od tej chwili projekt ma własne:

• Sieć kontenerów, dzięki której jego kontenery nie porozumieją się z kontenerami innego projektu.
• Katalog tokenów, w którym leżą dane uwierzytelniające do każdej usługi, z jaką łączy się projekt.
• Katalog domowy Claude, gdzie trzymane są dane uwierzytelniające Claude Code, sesje oraz stan onboardingu dla tego projektu.

Uruchomienie speedwave init ustawia nowy projekt jako aktywny. Samo speedwave, bez flagi --project, zawsze działa na projekcie aktywnym, a nie na tym, który pasowałby do twojego bieżącego katalogu. Gdy projekt już istnieje, zaloguj się w jego obrębie do Claude. Kroki znajdziesz w Twojej pierwszej sesji.

Gdzie leżą pliki

Wszystko, co Speedwave przechowuje dla projektu, znajduje się w katalogu danych, domyślnie ~/.speedwave/:

• Folder~/.speedwave/

  • config.json
  • Foldertokens/

    • Foldermy-project/

      • Folderslack/

        • …
      • Foldergitlab/

        • …
      • Folderllm/

        • …
  • Folderclaude-home/

    • Foldermy-project/

      • …

Pliki samego projektu zostają tam, gdzie były, czyli w katalogu na hoście, w którym uruchomiłeś speedwave init. Speedwave montuje ten katalog w kontenerze pod ścieżką /workspace.

Usuwanie projektu

Usunięcie projektu kasuje jedynie wymienione wyżej katalogi zarządzane przez Speedwave (tokeny, katalog domowy Claude i pozostałe). Nigdy nie narusza twojego drzewa źródłowego. Nie usuniesz projektu, na którym akurat pracujesz. Przełącz się najpierw na inny, w przeciwnym razie Speedwave odmówi i wyświetli błąd z prośbą o zmianę projektu.

Pełny obraz tego, jak projekty pozostają odizolowane od siebie i jak wybierany jest projekt aktywny, znajdziesz w projektach i sesjach.

Dokumentacja CLI Flaga --project, init i sposób ustalania projektu w szczegółach.