# Shelve

> Shelve Skill

- Skill: `onmax/shelve` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add onmax/shelve`
- Raw SKILL.md: https://api.skillmd.com/api/skills/onmax/shelve/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: onmax (https://skillmd.com/u/onmax)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/onmax/shelve

---

# Shelve Skill

Secrets management platform. CLI syncs `.env` files with cloud storage.

## When to Use

Load this skill when user mentions:
- "shelve" (the platform)
- Syncing env vars / secrets with team
- Pulling/pushing environment variables
- Running commands with injected secrets

## Quick Reference

```bash
# Auth
shelve login              # Authenticate with token from app.shelve.cloud/user/tokens
shelve logout             # Remove local credentials
shelve me                 # Show current user

# Core operations
shelve pull               # Pull env vars from Shelve → local .env
shelve push               # Push local .env → Shelve
shelve run <cmd>          # Run command with injected secrets (no .env file needed)

# Project management
shelve create             # Create new project
shelve config             # Show current configuration
shelve generate           # Generate .env.example
shelve upgrade            # Upgrade CLI
```

## Configuration

Config loaded from `shelve.json` (or `shelve.config.json`, `.shelverc.json`):

```json
{ "$schema": "https://raw.githubusercontent.com/HugoRCD/shelve/main/packages/types/schema.json", "slug": "team-slug", "project": "project-name", "confirmChanges": true, "autoCreateProject": true }
```

## Monorepo Support

Root `shelve.json` defines shared config (e.g., `slug`). Each package has own `shelve.json` with `project` name. Running commands at root executes for all packages with config.

## Loading Files

**Consider loading this reference file based on your task:**

- [ ] [cli.md](references/cli.md) - if need full CLI commands or config options

**DO NOT load all files at once.** Load only what's relevant to your current task.

