Claude Code Companion

SHIVA Code Dokumentation

Mach Claude Code persistent. Cross-Project Memory, automatische Integration, Cloud Sync.

Einführung

SHIVA Code ist ein CLI-Tool das Claude Code mit persistentem Gedächtnis ausstattet. Claude vergisst normalerweise alles nach jeder Session - SHIVA löst dieses Problem.

Persistent Memory

Claude vergisst nie mehr. Deine Präferenzen, dein Stil, deine Entscheidungen - alles bleibt erhalten.

Cross-Project

Verbinde Projekte. Claude weiss was in Project A passiert, wenn du an Project B arbeitest.

Auto-Integration

SHIVA integriert sich automatisch in Claude Code via Hooks und CLAUDE.md.

Installation

SHIVA Code benötigt Node.js 18+ und npm.

Terminal

npm install -g shiva-code

Voraussetzungen

Node.js 18 oder höher
npm oder yarn
Claude Code (installiert und konfiguriert)

Schnellstart

Nach der Installation brauchst du nur einen Befehl:

Terminal

$ shiva init

Scanning for projects...
✓ Found 12 projects
✓ Integrated with Claude Code
✓ SHIVA is ready!

Das war's! SHIVA hat deine Projekte gefunden und sich in Claude Code integriert. Ab jetzt hat Claude ein Gedächtnis.

Projekte scannen

SHIVA findet alle deine Projekte mit .git oder package.json

Integration erstellen

CLAUDE.md wird erstellt/aktualisiert mit SHIVA Context

Hooks registrieren

Claude Code wird so konfiguriert, dass SHIVA bei jeder Session läuft

shiva init

Initialisiert SHIVA und integriert es in Claude Code.

Syntax

shiva init [options]

Options:
  --path <path>   Spezifischer Pfad zum Scannen (default: ~)
  --deep          Tiefenscan (langsamer, findet mehr)
  --force         Überschreibt existierende Config

Was passiert bei init?

Scannt nach Projekten (git repos, package.json, etc.)
Erstellt ~/.shiva/ Konfigurationsordner
Generiert CLAUDE.md für jedes Projekt
Registriert Claude Code Hooks
Verbindet mit Cloud (wenn eingeloggt)

shiva sync

Synchronisiert Memories und Projektdaten.

Terminal

$ shiva sync

Syncing memories...
✓ 3 projects synced
✓ 15 memories updated

Syntax

shiva sync [options]

Options:
  --project <name>   Nur bestimmtes Projekt synchen
  --cloud            Mit Cloud synchronisieren (Pro)
  --local            Nur lokal synchen

shiva status

Zeigt den aktuellen Status von SHIVA.

Terminal

$ shiva status

SHIVA Code v1.0.0
━━━━━━━━━━━━━━━━━━━━━━
Projects:     12 local
Memories:     47 stored
Last Sync:    2 minutes ago
Cloud:        Connected (Pro)

shiva projects

Listet alle registrierten Projekte.

Terminal

$ shiva projects

┌────────────────────────┬────────────────┬─────────┐
│ Project                │ Path           │ Status  │
├────────────────────────┼────────────────┼─────────┤
│ shiva.li               │ ~/web/shiva.li │ Synced  │
│ my-api                 │ ~/web/my-api   │ Synced  │
│ loadsh.it              │ ~/web/loadsh   │ Pending │
└────────────────────────┴────────────────┴─────────┘

Syntax

shiva projects [options]

Options:
  --add <path>      Projekt manuell hinzufügen
  --remove <name>   Projekt entfernen
  --json            Output als JSON

shiva connect

Verbindet zwei Projekte für Cross-Project Context Sharing.

Terminal

$ shiva connect my-website my-api

✓ Projects connected
  my-website ←→ my-api

Verbundene Projekte teilen Kontext. Wenn Claude in Project A etwas lernt, ist diese Information auch in Project B verfügbar.

Beispiel Use Case

Du hast ein Frontend (my-website) und ein Backend (my-api). Verbinde sie, damit Claude bei Frontend-Arbeit die Backend-API kennt.

shiva login

Meldet dich bei SHIVA Cloud an (für Pro Features).

Terminal

$ shiva login

Opening browser for authentication...
✓ Logged in as user@example.com
✓ Pro plan active

Nach dem Login sind Cloud Sync und Web Dashboard verfügbar.

shiva start

Startet eine Claude Code Session mit SHIVA Kontext.

Terminal

$ shiva start my-api my-website

Starting multi-project session...
✓ Loaded context for my-api
✓ Loaded context for my-website
✓ Claude Code ready

Syntax

shiva start [projects...] [options]

Options:
  --issue <number>      GitHub Issue Session starten
  --pr <number>         PR Review Session starten
  --sandbox <mode>      Isolierte Sandbox (worktree|copy|docker)
  --docker              Docker Container Session
  --terminal <type>     Terminal (tmux|gnome|kitty|alacritty)

Issue Session

Startet eine Session mit GitHub Issue Kontext:

Terminal

$ shiva start --issue 42

Starting issue session for #42...
✓ Loaded issue: "Fix authentication bug"
✓ Context prepared

shiva resume

Setzt die letzte Session fort.

Terminal

$ shiva resume

Resuming last session...
✓ Context restored
✓ 3 uncommitted changes detected

Syntax

shiva resume [project] [options]

Options:
  --session <id>    Spezifische Session fortsetzen
  --list            Verfügbare Sessions anzeigen

shiva sessions

Listet alle Sessions auf.

Terminal

$ shiva sessions

Session        | Project        | Started      | Status
---------------|----------------|--------------|--------
ses_abc123     | my-api         | 2h ago       | Active
ses_def456     | my-website     | Yesterday    | Paused

Syntax

shiva sessions [options]

Options:
  --all            Alle Sessions (inkl. beendete)
  --project <name> Filter nach Projekt
  --json           Output als JSON

Sandbox Mode

Führe riskante Änderungen in einer isolierten Umgebung aus.

Terminal

$ shiva start --sandbox worktree

Creating sandbox environment...
✓ Git worktree created
✓ Isolated environment ready
⚠ Changes will not affect main branch

Sandbox Optionen

Mode	Beschreibung	Use Case
`worktree`	Git Worktree (empfohlen)	Schnell, teilt .git
`copy`	Vollständige Kopie	Komplette Isolation
`docker`	Docker Container	Maximale Isolation

Sandbox Session beenden

Terminal

$ shiva session apply

Applying sandbox changes...
✓ Changes merged to main branch
✓ Sandbox cleaned up

Commands

shiva session apply     # Änderungen übernehmen
shiva session discard   # Änderungen verwerfen
shiva session status    # Sandbox Status anzeigen

shiva search

Durchsucht Memories über alle Projekte.

Terminal

$ shiva search "authentication"

Searching memories...
Project        | Category   | Content
---------------|------------|---------------------------
my-api         | solution   | JWT tokens for auth
my-website     | convention | OAuth2 flow implemented

Syntax

shiva search <query> [options]

Options:
  --project <name>    Nur in bestimmtem Projekt
  --category <cat>    Filter nach Kategorie (stack|config|solution|convention|...)
  --limit <n>         Anzahl Ergebnisse (default: 10)

shiva tags

Verwaltet Projekt-Tags für bessere Organisation.

Terminal

$ shiva tags

Project: my-api
Tags: backend, api, typescript, auth, database

$ shiva tags --add security
✓ Tag 'security' added

Syntax

shiva tags [options]

Options:
  --add <tag>       Tag hinzufügen
  --remove <tag>    Tag entfernen
  --project <name>  Projekt spezifizieren

shiva context

Zeigt und lädt Projekt-Kontext.

Terminal

$ shiva context

Loading context for my-api...
Project: my-api
Memories: 23 active
Connected: my-website
Last Update: 2 minutes ago

Wird automatisch bei Session Start aufgerufen (via Hooks).

shiva forget

Entfernt spezifische Memories.

Terminal

$ shiva forget --key "old_api_pattern"

✓ Memory removed from my-api

Syntax

shiva forget [options]

Options:
  --key <key>       Spezifische Memory löschen
  --all             Alle Memories löschen (mit Bestätigung)
  --older-than <d>  Memories älter als X Tage

shiva export

Exportiert Projektdaten und Memories.

Terminal

$ shiva export --format json

Exporting project data...
✓ Exported to shiva-export-2024-01-15.json

Syntax

shiva export [options]

Options:
  --format <fmt>    Format: json|yaml|markdown
  --output <path>   Output Datei
  --project <name>  Nur bestimmtes Projekt

shiva scan

Scannt Packages auf bekannte Sicherheitslücken.

Terminal

$ shiva scan

Scanning packages for vulnerabilities...
Package          | Version  | Severity | Issue
-----------------|----------|----------|---------------------
lodash           | 4.17.15  | HIGH     | Prototype Pollution
axios            | 0.21.0   | MODERATE | SSRF vulnerability

⚠ 2 vulnerabilities found. Run 'npm audit fix' to resolve.

Syntax

shiva scan [package] [options]

Options:
  --manager <mgr>   Package Manager (npm|pip|cargo)
  --verbose         Detaillierte Ausgabe
  --fix             Automatisch fixen wenn möglich

Hinweis

Der Scan nutzt öffentliche Vulnerability-Datenbanken (NVD, npm audit, etc.).

shiva secrets

Verwaltet Secrets sicher im SHIVA Vault.

Terminal

$ shiva secrets list

Key                | Scope            | Last Updated
-------------------|------------------|---------------
API_KEY            | my-api           | 3 days ago
DATABASE_URL       | my-api           | 1 week ago

$ shiva secrets add STRIPE_KEY sk_test_xxx
✓ Secret added to vault

Syntax

shiva secrets <command> [options]

Commands:
  list              Alle Secrets auflisten
  add <key> <val>   Secret hinzufügen
  get <key>         Secret abrufen
  delete <key>      Secret löschen

Options:
  --project <name>  Projekt-Scope

Sicherheit

Secrets werden lokal verschlüsselt gespeichert. Mit Pro Plan zusätzlich Cloud-Sync mit E2E Verschlüsselung.

shiva package

Gruppiert Projekte in Packages für gemeinsames Management.

Terminal

$ shiva package list

Package            | Projects
-------------------|----------------------------------------
frontend-stack     | my-website, admin-panel, docs
backend-services   | my-api, auth-service, worker

Syntax

shiva package <command> [options]

Commands:
  list                  Alle Packages auflisten
  create <name>         Package erstellen
  add <pkg> <project>   Projekt zu Package hinzufügen
  remove <pkg> <proj>   Projekt entfernen
  start <name>          Alle Projekte im Package starten
  delete <name>         Package löschen

Package starten

Terminal

$ shiva package start frontend-stack

Starting package: frontend-stack
✓ Started: my-website
✓ Started: admin-panel
✓ Started: docs
All 3 projects ready

shiva hook

Verwaltet Git und Claude Code Hooks.

Terminal

$ shiva hook --install

Installing Git hooks...
✓ pre-commit hook installed
✓ post-commit hook installed
✓ Hooks registered with Claude Code

Syntax

shiva hook [options]

Options:
  --install       Git Hooks installieren
  --enable        Hooks aktivieren
  --disable       Hooks deaktivieren
  --list          Installierte Hooks anzeigen

shiva doctor

Überprüft die SHIVA Installation und Konfiguration.

Terminal

$ shiva doctor

SHIVA Health Check
✓ Node.js 20.10.0
✓ Claude Code installed
✓ Git configured
✓ SHIVA config valid
✓ Cloud connection active

All systems operational!

Prüft Node.js Version, Claude Code Installation, Git, SHIVA Config und Cloud-Verbindung.

shiva upgrade

Aktualisiert SHIVA Code auf die neueste Version.

Terminal

$ shiva upgrade

Checking for updates...
Current: 1.2.0
Latest:  1.3.0

Upgrading SHIVA Code...
✓ Updated to v1.3.0

Syntax

shiva upgrade [options]

Options:
  --check         Nur auf Updates prüfen
  --force         Upgrade erzwingen
  --beta          Beta-Versionen einschliessen

shiva stats

Zeigt Nutzungsstatistiken an.

Terminal

$ shiva stats

SHIVA Usage Statistics
Sessions this week:     23
Memories created:       156
Syncs performed:        45
Most active project:    my-api

Syntax

shiva stats [options]

Options:
  --week          Diese Woche (default)
  --month         Dieser Monat
  --all           Gesamte Zeit
  --json          Output als JSON

Claude Code Integration

SHIVA integriert sich nahtlos in Claude Code über drei Mechanismen:

1. CLAUDE.md

SHIVA fügt Context-Informationen zur CLAUDE.md hinzu, die Claude bei jedem Start liest.

2. Hooks

Bei Session Start und nach Tool-Nutzung werden SHIVA Commands ausgeführt.

3. MCP Server

Optionaler MCP Server für tiefere Integration und Real-Time Memory Updates.

Hooks

SHIVA nutzt Claude Code Hooks für automatische Integration.

~/.claude/settings.json

{
  "hooks": {
    "SessionStart": ["shiva context"],
    "PreToolUse": [],
    "PostToolUse": ["shiva learn"]
  }
}

Hook Beschreibungen

Hook	Command	Beschreibung
SessionStart	`shiva context`	Lädt Projekt-Kontext und Memories in die Session
PostToolUse	`shiva learn`	Extrahiert neue Learnings nach Tool-Nutzung

CLAUDE.md

SHIVA generiert und aktualisiert die CLAUDE.md Datei in deinen Projekten.

CLAUDE.md (generiert)

# Project: shiva.li

## SHIVA Context
This project is connected to SHIVA Code.
Cross-project memories are enabled.

## Project Memory
- Uses Astro + Cloudflare Workers
- Follows dark theme design
- German language (Hochdeutsch)

## Connected Projects
- my-api (Backend API)

Die CLAUDE.md enthält:

SHIVA Context - Marker für SHIVA Integration
Project Memory - Wichtige Projekt-Informationen
Connected Projects - Cross-Project Links

Cloud Sync (Pro)

Mit dem Pro Plan kannst du deine SHIVA Daten in der Cloud speichern.

Cross-Device

Deine Memories auf allen Geräten verfügbar.

Web Dashboard

Projekte und Memories im Browser verwalten.

Backup

Automatisches Backup deiner SHIVA Daten.

Terminal

# Login für Cloud Features
shiva login

# Cloud Sync aktivieren
shiva sync --cloud

# Dashboard öffnen
shiva dashboard

API Reference

Die SHIVA API ermöglicht programmatischen Zugriff auf deine Projekte und Memories.

Base URL https://api.shiva.li/api

Projekt synchronisieren

POST /projects/:id/sync

Request

POST /api/projects/:id/sync
Authorization: Bearer <token>
Content-Type: application/json

{
  "claude_md_content": "# Project...",
  "memories": [
    { "key": "tech_stack", "value": "Astro + Workers" }
  ],
  "metadata": {
    "language": "typescript",
    "framework": "astro"
  }
}

Weitere Endpoints

Methode	Endpoint	Beschreibung
GET	`/projects`	Alle Projekte abrufen
POST	`/projects`	Projekt erstellen/aktualisieren
GET	`/projects/:id`	Einzelnes Projekt mit Memories
POST	`/projects/connect`	Projekte verbinden
GET	`/projects/stats`	Statistiken abrufen

Troubleshooting

SHIVA findet meine Projekte nicht

Stelle sicher, dass deine Projekte ein .git Verzeichnis oder eine package.json haben. Alternativ füge Projekte manuell hinzu:

shiva projects --add /path/to/project

Claude Code Hooks funktionieren nicht

Überprüfe deine Claude Code Konfiguration:

cat ~/.claude/settings.json

Stelle sicher, dass die Hooks korrekt registriert sind. Führe shiva init --force aus um die Hooks neu zu setzen.

Cloud Sync funktioniert nicht

Überprüfe deinen Login-Status:

shiva status

Bei Problemen: shiva logout und dann shiva login

FAQ

Funktioniert SHIVA offline?

Ja! Das CLI Tool und lokales Memory funktionieren vollständig offline. Nur Cloud Sync benötigt Internet.

Welche Daten speichert SHIVA?

SHIVA speichert Projekt-Metadaten, Memories (extrahierte Learnings), und die CLAUDE.md Inhalte. Kein Code wird gespeichert.

Ist SHIVA Open Source?

Ja! Das CLI Tool ist vollständig Open Source: github.com/AimTaim/shiva-code

Funktioniert SHIVA mit anderen AI Tools?

SHIVA ist speziell für Claude Code optimiert. Support für andere Tools (Cursor, Copilot) ist geplant.

Bereit loszulegen?

Installiere SHIVA und mach Claude Code persistent.

npm install -g shiva-code && shiva init