Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (shiva-code) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

SHIVA Code CLI

Makes Claude Code Persistent - Cross-Project Memory for AI Coding

Features

Persistent Memory - Memories survive across sessions and projects
Cloud Sync - Sync your data between devices
Project Packages - Launch multiple projects at once
Secure Secrets - Encrypted secret storage with vault
Docker Support - Isolated development environments
GitHub Integration - Issues, PRs, and context at your fingertips
Session Management - Resume, restore, and organize sessions

Installation

Native Binary (Recommended)

curl -fsSL https://shiva.li/install | bash

npm

npm install -g shiva-code

From Source

git clone https://github.com/Aimtaim/shiva-code.git
cd shiva-code
npm install
npm run build
npm link

Quick Start

# Initialize project
cd your-project
shiva init

# Save a memory
shiva remember "User prefers TypeScript" --category preference

# Search memories
shiva search "typescript"

# Start Claude with context
claude

Commands

Session Management

Command	Alias	Description
`shiva sessions`	`ss`	List all Claude sessions
`shiva resume`	`res`	Resume a session
`shiva restore`	`rst`	Restore a crashed session
`shiva start`	`st`	Start multiple projects

Memory & Context

Command	Alias	Description
`shiva remember`	`rem`, `r`	Save a memory
`shiva search`	`s`, `find`	Search memories
`shiva forget`	`fg`	Delete a memory
`shiva context`	-	Show current context
`shiva tags`	-	Manage session tags
`shiva export`	-	Export sessions
`shiva import`	-	Import sessions

Project Management

Command	Alias	Description
`shiva init`	`i`	Initialize a project
`shiva sync`	`sy`	Sync with cloud
`shiva status`	`stat`	Show project status
`shiva projects`	`proj`, `p`	List all projects
`shiva config`	`cfg`	Manage settings

GitHub Integration

Command	Alias	Description
`shiva github`	`gh`	GitHub status/login
`shiva issues`	`iss`	Show GitHub issues
`shiva prs`	`pr`	Show pull requests

Security

Command	Alias	Description
`shiva secrets`	`sec`	Manage secrets
`shiva scan`	`sc`	Security scan

Advanced

Command	Alias	Description
`shiva package`	`pkg`	Manage project packages
`shiva docker`	`dk`	Docker mode
`shiva sandbox`	`sb`	Sandbox mode
`shiva workflow`	`wf`	Manage workflows
`shiva hook`	`hk`	Manage hooks

System

Command	Alias	Description
`shiva doctor`	`doc`	System check
`shiva upgrade`	`up`	Update SHIVA
`shiva stats`	-	Show analytics
`shiva validate`	-	Validate configuration

Debug Mode

Enable debug mode for troubleshooting:

# Via flag
shiva --debug status

# Via environment variable
SHIVA_DEBUG=1 shiva status

Configuration

SHIVA stores configuration in ~/.config/shiva-code/:

config.json - Main configuration
packages.json - Package definitions
secrets.json - Encrypted secrets (local)

Project-specific settings are stored in .shiva/:

config.json - Project configuration
CLAUDE.md - Claude context file

Environment Variables

Variable	Description
`SHIVA_DEBUG`	Enable debug mode (`1` to enable)
`SHIVA_API_URL`	Override API endpoint
`SHIVA_TOKEN`	Authentication token

CLAUDE.md Integration

SHIVA automatically manages your CLAUDE.md file, which Claude Code uses for context. The file includes:

Project information
Saved memories
Tech stack details
Custom instructions

Documentation

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Type check
npm run typecheck

# Development mode (watch)
npm run dev

Contributing

Contributions are welcome! Please read our Contributing Guide for details.

License

MIT - see LICENSE for details.

shiva-code