# Oli Storage Manager

> A unified data management skill using 'oli' to interface with S3, GCS, Azure, and other remote storage with built-in safety guardrails.

- **Type:** Skill
- **Install:** `agentstack add skill-tkolleh-skills-oli-storage-manager`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [tkolleh](https://agentstack.voostack.com/s/tkolleh)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [tkolleh](https://github.com/tkolleh)
- **Source:** https://github.com/tkolleh/skills/tree/main/oli-storage-manager

## Install

```sh
agentstack add skill-tkolleh-skills-oli-storage-manager
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Oli Storage Manager Skill

## When to use me
- When the user needs to interact with **remote** storage services (AWS S3, Google Cloud Storage, Azure Blob, etc.).
- When a user asks to list, move, copy, or delete files across different storage backends using `oli`.
- When the user wants to visualize the directory structure of a **remote** bucket, sftp server, or some other **remote** data store.

## What I do
- **Profile Management**: Automatically detects and prompts for `oli` profiles from `~/Library/Application Support/oli/config.toml`.
- **Data Exploration**: Generates recursive JSON tree layouts of storage directories.
- **Unified File Ops**: Executes standard file operations (`ls`, `cp`, `mv`, `rm`, `cat`, `stat`) across all OpenDAL-supported services.
- **Safety Enforcement**: Intercepts destructive actions to require explicit human confirmation.

## DO NOT USE ME FOR THE LOCAL FILE SYSTEM
- I am for **remote** only. 
- Use `serena`, `ripgrep` or `fd` when the user wants to explore the local file system.

---

## CRITICAL SAFETY RULES (MANDATORY)
**Before executing any command that modifies or deletes data, you MUST follow this protocol:**

1. **Identify Destructive Intent**: This includes `oli rm`, `oli rb`, or `oli cp`/`oli mv` when the destination already exists (overwriting).
2. **Request Explicit Confirmation**: Pause and ask: *"I am about to [Action] [Target]. Do you want to proceed? (Yes/No)"*.
3. **No Implicit Consent**: Do not proceed based on vague affirmative statements. Confirm each major batch of deletions.
4. **Pre-Check**: Use `oli stat` or `oli ls` to verify the existence of files before attempting to overwrite or delete them.

---

## 1. Profile Discovery & Validation
- **Path**: `~/Library/Application Support/oli/config.toml`
- **Action**: Parse `[profiles.name]` entries.
- **Protocol**: If no profile is provided in the prompt, list discovered profiles and ask: *"Which storage profile should I use?"*

## 2. Path & Tree Exploration
If the user requests to "explore," "layout," or "show tree":
1. Run `oli ls -R profile:/path`.
2. **Output Format**: Transform the flat list into a hierarchical **JSON** structure.
   
   **Example JSON Output:**
   ```json
   {
     "profile": "prod-s3",
     "root": "/data",
     "structure": {
       "logs": {
         "2024-01-01.log": {"type": "file", "size": "1.2MB"},
         "2024-01-02.log": {"type": "file", "size": "800KB"}
       },
       "config.json": {"type": "file", "size": "4KB"}
     }
   }

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [tkolleh](https://github.com/tkolleh)
- **Source:** [tkolleh/skills](https://github.com/tkolleh/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tkolleh-skills-oli-storage-manager
- Seller: https://agentstack.voostack.com/s/tkolleh
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.