Storegate CLI (sgcli) Användarmanual
Storegate CLI (sgcli) Användarmanual
Introduktion
sgcli är ett kommandoradsverktyg (CLI) för att hantera din Storegate-lagring direkt från terminalen. Det stöder snabba,
återupptakbara filöverföringar, rekursiva katalogoperationer, server-sida kopiering/flytt och en interaktiv
filhanterare med dubbla paneler.
Nyckelfunktioner:
- Multiplattform: Fungerar på Windows, macOS och Linux.
- Återupptakbara överföringar: Avbrutna upp- och nedladdningar återupptas automatiskt från avbrytspunkten.
- Rekursiva operationer: Ladda upp eller ner hela mappstrukturer med ett enda kommando.
- Server-sida-hastighet: Kopiera och flytta filer direkt på servern — ingen lokal bandbredd används för själva
överföringen.
- Interaktiv TUI: En fullfjädrad filhanterare med dubbla paneler (sgcli tui).
- Versionsnotiser: Notifierar automatiskt när en nyare version finns tillgänglig.
1. Installation
Ladda ner det färdigbyggda arkivet för ditt operativsystem från Releases-sidan.
Arkivnamn
| Plattform | Arkivfilnamn |
|-----------|-------------|
| macOS (Apple Silicon M1/M2/M3) | sgcli-darwin-arm64.tar.gz |
| macOS (Intel) | sgcli-darwin-amd64.tar.gz |
| Linux (64-bit) | sgcli-linux-amd64.tar.gz |
| Windows (64-bit) | sgcli-windows-amd64.zip |
Varje arkiv innehåller en enda binärfil: sgcli (eller sgcli.exe på Windows).
macOS
1. Ladda ner .tar.gz-arkivet som matchar din Mac.
2. Packa upp det (dubbelklicka i Finder, eller i Terminal):
tar -xzf sgcli-darwin-arm64.tar.gz
3. Installera genom att flytta binären till en katalog i din PATH:
sudo mv sgcli /usr/local/bin/sgcli
4. Verifiera:
sgcli --version
Linux
1. Ladda ner .tar.gz-arkivet.
2. Packa upp:
tar -xzf sgcli-linux-amd64.tar.gz
3. Installera:
sudo mv sgcli /usr/local/bin/sgcli
4. Gör körbar (vid behov):
chmod +x /usr/local/bin/sgcli
5. Verifiera:
sgcli --version
Windows
1. Ladda ner .zip-arkivet.
2. Packa upp det (högerklicka → Extrahera alla, eller använd 7-Zip).
3. Flytta sgcli.exe till en mapp som ingår i systemets PATH, till exempel C:\Tools.
- Lägg till en mapp i PATH: Systeminställningar → Avancerat → Miljövariabler → Path → Redigera → Ny.
4. Verifiera genom att öppna en ny kommandotolk eller PowerShell-terminal:
sgcli --version
2. Autentisering
Logga in
Innan du kan använda sgcli måste du logga in på ditt Storegate-konto. Processen använder OAuth2 och öppnar din
webbläsare.
sgcli login
Efter lyckad inloggning sparar sgcli en krypterad sessionsfil:
| Plattform | Plats |
|-----------|-------|
| macOS / Linux | ~/.storegate_session.bin |
| Windows | %USERPROFILE%\.storegate_session.bin |
Sessionen uppdateras automatiskt när den löper ut — du behöver inte logga in igen.
Logga ut
sgcli logout
Återkallar sessionen på servern och tar bort den lokala sessionsfilen.
3. Kommandon
ls — Lista filer och mappar
sgcli ls [FJÄRRSÖKVÄG]
Listar innehållet i en fjärrkatalog. Standardvärde är roten (/) om ingen sökväg anges.
sgcli ls /
sgcli ls /Dokument/Rapporter
put — Ladda upp
sgcli put [LOKAL_SÖKVÄG] [FJÄRRSÖKVÄG]
Laddar upp en lokal fil eller mapp rekursivt. Om en fil redan finns på destinationen erbjuds du att Skriva över
(Overwrite), Hoppa över (Skip), tillämpa valet på Alla (All) återstående konflikter, eller Avsluta (Quit).
| Flagga | Beskrivning |
|--------|-------------|
| -f, --force | Skriv över utan att fråga |
# Ladda upp en enskild fil
sgcli put ./video.mp4 /Videos
# Ladda upp en hel mapp rekursivt
sgcli put ./MittProjekt /
# Tvinga överskrivning
sgcli put config.json /Inställningar -f
get — Ladda ner
sgcli get [FJÄRRSÖKVÄG] [LOKAL_SÖKVÄG]
Laddar ner en fjärrfil eller mapp rekursivt. Om en delvis nedladdad fil finns lokalt erbjuds du att Återuppta (Resume),
Skriva över (Overwrite) eller Hoppa över (Skip) — i stället för ett generiskt överskrivningsfråga.
| Flagga | Beskrivning |
|--------|-------------|
| -f, --force | Skriv över utan att fråga |
# Ladda ner en fil till aktuell katalog
sgcli get /Dokument/rapport.pdf .
# Ladda ner en mapp
sgcli get /Foton ./Nedladdningar -f
cp — Server-sida kopiering
sgcli cp [FJÄRRKÄLLA] [FJÄRRDESTINATION]
Kopierar filer eller mappar direkt på servern. Ingen lokal bandbredd används.
| Flagga | Beskrivning |
|--------|-------------|
| -f, --force | Skriv över om destinationen finns |
sgcli cp /Dokument/rapport.pdf /Arkiv/
sgcli cp /Foton /Backup/Foton_Kopia
mv — Flytta eller byt namn
sgcli mv [FJÄRRKÄLLA] [FJÄRRDESTINATION]
Flyttar eller byter namn på en fil eller mapp på servern.
| Flagga | Beskrivning |
|--------|-------------|
| -f, --force | Hoppa över bekräftelse |
# Byt namn
sgcli mv /Dokument/utkast.txt /Dokument/slutlig.txt
# Flytta till en mapp
sgcli mv /bild.jpg /Foton/
rm — Ta bort
sgcli rm [FJÄRRSÖKVÄG]
Tar permanent bort en fil eller mapp.
| Flagga | Beskrivning |
|--------|-------------|
| -f, --force | Ta bort utan bekräftelse |
sgcli rm /Papperskorg/gammal_fil.txt
sgcli rm /TempMapp -f
mkdir — Skapa mapp
sgcli mkdir [FJÄRRSÖKVÄG]
Skapar en ny mapp (inklusive mellanliggande föräldramappar om de saknas).
sgcli mkdir /Projekt/NyKund/Tillgångar
touch — Skapa tom fil
sgcli touch [FJÄRRSÖKVÄG]
Skapar en ny tom fil på servern.
| Flagga | Beskrivning |
|--------|-------------|
| -f, --force | Skriv över om filen finns |
sgcli touch /Dokument/anteckningar.txt
cat — Visa filinnehåll
sgcli cat [FJÄRRFILENS_SÖKVÄG]
Laddar ner och skriver ut innehållet i en fjärrtextfil till terminalen.
sgcli cat /Inställningar/config.txt
open — Öppna i standardprogram
sgcli open [FJÄRRSÖKVÄG]
Laddar ner filen till en tillfällig plats och öppnar den med systemets standardprogram för filtypen.
Obs: Detta är skrivskyddat. Ändringar sparas inte tillbaka till Storegate. Använd F4 i TUI för att redigera och spara
till molnet.
sgcli open /Ekonomi/budget.xlsx
diff — Jämför lokalt och fjärran
sgcli diff [LOKAL_SÖKVÄG] [FJÄRRSÖKVÄG]
Jämför en lokal mapp med en fjärrmapp och visar skillnaderna.
| Status | Betydelse |
|--------|-----------|
| ✅ OK | Samma fil finns på båda platser (storlek och datum stämmer) |
| 👉 SAKNAS (Fjärr) | Finns lokalt, saknas på servern |
| 👈 SAKNAS (Lokalt) | Finns på servern, saknas lokalt |
| ⚠️ STORLEK | Samma namn, olika filstorlek |
| ⏰ TID | Samma storlek, olika ändringstid |
| ❌ TYP | Fil på ett ställe, mapp på det andra |
sgcli diff ./Foton /Backup/Foton
df — Lagringsutrymme
sgcli df
Visar total kapacitet, använt utrymme och ledigt utrymme för ditt konto.
du — Diskanvändning för en sökväg
sgcli du [FJÄRRSÖKVÄG]
Beräknar den totala storleken för en fjärrfil eller mapp.
sgcli du /Videos
web — Öppna webbgränssnittet
sgcli web
Öppnar ditt Storegate-konto i standardwebbläsaren.
tui — Terminalbaserat användargränssnitt
sgcli tui
Startar den interaktiva filhanteraren med dubbla paneler (se avsnitt 4).
4. Terminalbaserat användargränssnitt (TUI)
TUI ger en filhanterare med dubbla paneler: vänster panel visar ditt lokala filsystem, höger panel visar din
Storegate-lagring i molnet.
Kortkommandon
| Tangent | Funktion |
|---------|----------|
| Tab | Växla aktiv panel |
| F1 | Visa hjälp |
| F2 | Växla sortering (Namn → Storlek → Datum) |
| F3 | Visa filinnehåll |
| F4 | Redigera fil (låser filen på servern, laddar upp vid sparande) |
| Shift+F4 / Ctrl+N | Skapa ny tom fil (Touch) |
| F5 | Kopiera markerade objekt — dialog där du kan ändra målsökvägen |
| F6 | Flytta markerade objekt — dialog där du kan ändra målsökvägen |
| Ctrl+E | Byt namn på markerat objekt |
| F7 | Skapa mapp |
| F8 / Del | Ta bort markerade objekt |
| F9 | Markera filer med mönster (t.ex. *.txt) |
| F10 | Avsluta |
| F12 | Växla panel mellan Lokal / Fjärr-vy |
| Space | Markera / avmarkera objekt |
| Ctrl+A | Markera alla |
| + / - | Markera / avmarkera med mönster |
| * | Invertera markering |
| Esc | Avbryt pågående överföring (när en överföring pågår) |
| Ctrl+C | Avbryt pågående överföring, eller avsluta om ingen överföring pågår |
Kopiera- och Flytta-dialoger (F5 / F6)
När du kopierar eller flyttar öppnas en dialog förifylld med målsökvägen. Du kan:
- Redigera sökvägen för att flytta filer till en annan plats.
- Ändra filnamnet för att byta namn i samband med kopiering eller flytt.
Överföringsförlopp
En förloppsruta visas under upp- och nedladdningar med filnamn, förloppsindikator och antal överförda byte. Tryck Esc
eller Ctrl+C för att avbryta.
5. Skal-autokomplettering
Aktivera tab-komplettering för kommandon och fjärrsökvägar.
Bash
Lägg till i ~/.bashrc eller ~/.bash_profile:
source <(sgcli completion bash)
Ladda om med source ~/.bashrc eller öppna en ny terminal.
Zsh
Lägg till i ~/.zshrc:
source <(sgcli completion zsh)
Ladda om med source ~/.zshrc eller öppna en ny terminal.
Fish
Kör en gång:
sgcli completion fish > ~/.config/fish/completions/sgcli.fish
PowerShell
Öppna din profilfil för redigering:
notepad $PROFILE
Lägg till följande rad och spara:
. (sgcli completion powershell | Out-String)
Ladda om med . $PROFILE eller öppna en ny PowerShell-terminal.
6. Versionsnotiser
sgcli kontrollerar automatiskt om en ny version finns tillgänglig efter varje kommando. Om en nyare version finns visas
en notis:
💡 New version available!
Download: https://example.com/sgcli-1.1.0-darwin-arm64.tar.gz
Notisen skrivs även till loggfilen, vilket gör den synlig även när utdata omdirigeras (t.ex. i cron-jobb).
Kontrollen är tyst vid alla fel (nätverksproblem, timeouts m.m.) och blockerar aldrig kommandot från att slutföras.
7. Globala flaggor
Dessa flaggor kan användas med vilket kommando som helst:
| Flagga | Beskrivning |
|--------|-------------|
| --no-log | Inaktivera skrivning av loggfiler till disk |
| --help | Visa hjälp för ett kommando |
| --version | Visa aktuell version |
Loggfiler skrivs till:
| Plattform | Plats |
|-----------|-------|
| macOS | ~/Library/Logs/sgcli/ |
| Linux | ~/.local/state/sgcli/logs/ |
| Windows | %LOCALAPPDATA%\sgcli\Logs\ |